From fd0d2e090bdec5759b1368e2ea11ebd1cbc498da Mon Sep 17 00:00:00 2001
From: Eamon Bauman <eamon@eamonbauman.com>
Date: Tue, 3 Nov 2020 14:11:43 -0600
Subject: [PATCH] added docs for logging migration

---
 .../logging/migration/rancher_logging.png     | Bin 0 -> 28466 bytes
 .../v2.x/en/logging/v2.5/migrating/_index.md  | 191 ++++++++++++++++++
 2 files changed, 191 insertions(+)
 create mode 100644 assets/img/rancher/logging/migration/rancher_logging.png
 create mode 100644 content/rancher/v2.x/en/logging/v2.5/migrating/_index.md

diff --git a/assets/img/rancher/logging/migration/rancher_logging.png b/assets/img/rancher/logging/migration/rancher_logging.png
new file mode 100644
index 0000000000000000000000000000000000000000..1815c4ab7fdcd43d156d979694b0388a2dc35d21
GIT binary patch
literal 28466
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
ZJ2e-pTKHU6z<v8PB{_B3GHJ8G{{m2Pu`2)o

literal 0
HcmV?d00001

diff --git a/content/rancher/v2.x/en/logging/v2.5/migrating/_index.md b/content/rancher/v2.x/en/logging/v2.5/migrating/_index.md
new file mode 100644
index 00000000000..eb44ebac6f3
--- /dev/null
+++ b/content/rancher/v2.x/en/logging/v2.5/migrating/_index.md
@@ -0,0 +1,191 @@
+---
+title: Migrating to Rancher v2.5 Logging
+weight: 5
+aliases:
+  - /rancher/v2.x/en/logging/migrating
+---
+Starting in v2.5, the logging feature available within Rancher has been completely overhauled. The [logging operator](https://github.com/banzaicloud/logging-operator) from Banzai Cloud has been adopted; Rancher configures this tooling for use when deploying logging.
+
+Among the many features and changes in the new logging functionality is the removal of project-specific logging configurations. Instead, one now configures logging at the namespace level. Cluster-level logging remains available, but configuration options differ. 
+
+> Note: The pre-v2.5 user interface is now referred to as the _Cluster Manager_. The v2.5+ dashboard is referred to as the _Cluster Explorer_. 
+
+## Installation
+
+To install logging in Rancher v2.5+, use the following steps:
+
+1. Open the Rancher dashboard. This can be done by clicking the _Cluster Explorer_ button within the cluster context, or from the global page in the _Cluster Manager_.
+
+2. Once within the _Cluster Explorer_, navigate to _Apps & Marketplace_ from the dropdown in the upper-left corner of the dashboard. 
+
+3. Once in the _Apps & Marketplace_ section, locate the "rancher-logging" chart. It is available as part of the "Rancher" repository, installed by default in Rancher v2.5+:
+
+    ![rancher logging chart image](../.../../../../../../../../assets/img/rancher/logging/migration/rancher_logging.png)
+
+4. Scroll to the bottom of the page and click _Install_. 
+
+## Terminology & Familiarity
+
+In v2.5, logging configuration is centralized under a _Logging_ menu option available in the _Cluster Explorer_. It is from this menu option that logging for both cluster and namespace is configured. 
+
+> Note: Logging is installed on a per-cluster basis. You will need to navigate between clusters to configure logging for each cluster. 
+
+There are four key concepts to understand for v2.5+ logging:
+
+1. Outputs
+   
+    _Outputs_ are a configuration resource that determine a destination for collected logs. This is where settings for aggregators such as ElasticSearch, Kafka, etc. are stored. _Outputs_ are namespaced resources.
+
+2. Flows
+
+    _Flows_ are a configuration resource that determine collection, filtering, and destination rules for logs. It is within a flow that one will configure what logs to collect, how to mutate or filter them, and which outputs to send the logs to. _Flows_ are namespaced resources, and can connect either to an _Output_ in the same namespace, or a _ClusterOutput_. 
+
+3. ClusterOutputs
+
+    _ClusterOutputs_ serve the same functionality as _Outputs_, except they are a cluster-scoped resource. _ClusterOutputs_ are necessary when collecting logs cluster-wide, or if you wish to provide an output to all namespaces in your cluster. 
+
+4. ClusterFlows
+
+    _ClusterFlows_ serve the same function as _Flows_, but at the cluster level. They are used to configure log collection for an entire cluster, instead of on a per-namespace level. _ClusterFlows_ are also where mutations and filters are defined, same as _Flows_ (in functionality).
+
+# Cluster Logging
+
+To configure cluster-wide logging for v2.5+ logging, one needs to setup a _ClusterFlow_. This object defines the source of logs, any transformations or filters to be applied, and finally the output(s) for the logs. 
+
+> Important: _ClusterFlows_ must be defined within the `cattle-logging-system` namespace. _ClusterFlows_ will not work if defined in any other namespace. 
+
+In legacy logging, in order to collect logs from across the entire cluster, one only needed to enable cluster-level logging and define the desired output. This basic approach remains in v2.5+ logging. To replicate legacy cluster-level logging, follow these steps:
+
+1. Define a _ClusterOutput_ according to the instructions found under [Output Configuration](#output-configuration)
+2. Create a _ClusterFlow_, ensuring that it is set to be created in the `cattle-logging-system` namespace
+   1. Remove all _Include_ and _Exclude_ rules from the flow definition. This ensures that all logs are gathered.
+   2. You do not need to configure any filters if you do not wish - default behavior does not require their creation
+   3. Define your cluster output(s)
+
+This will result in logs from all sources in the cluster (all pods, and all system components) being collected and sent to the output(s) you defined in the _ClusterFlow_. 
+
+# Project Logging
+
+Logging in v2.5+ is not project-aware. This means that in order to collect logs from pods running in project namespaces, you will need to define _Flows_ for those namespaces. 
+
+To collect logs from a specific namespace, follow these steps:
+
+1. Define an _Output_ or _ClusterOutput_ according to the instructions found under [Output Configuration](#output-configuration)
+2. Create a _Flow_, ensuring that it is set to be created in the namespace in which you want to gather logs.
+   1. If you wish to define _Include_ or _Exclude_ rules, you may do so. Otherwise, removal of all rules will result in all pods in the target namespace having their logs collected. 
+   2. You do not need to configure any filters if you do not wish - default behavior does not require their creation
+   3. Define your output(s) - these can be either _ClusterOutput_ or _Output_ objects.
+
+This will result in logs from all sources in the namespace (pods) being collected and sent to the output(s) you defined in your _Flow_.
+
+> To collect logs from a project, repeat the above steps for every namespace within the project. Alternatively, you can label your project workloads with a common label (e.g. `project=my-project`) and use a _ClusterFlow_ to collect logs from all pods matching this label. 
+
+# Output Configuration
+In legacy logging, there are five logging destinations to choose from: Elasticsearch, Splunk, Kafka, Fluentd, and Syslog. With the exception of Syslog, all of these destinations are available in logging v2.5+. 
+
+
+## Elasticsearch
+
+| Legacy Logging                                | v2.5+ Logging                     | Notes                                                     |
+|-----------------------------------------------|-----------------------------------|-----------------------------------------------------------|
+| Endpoint                                      | Target -> Host                    | Make sure to specify Scheme (https/http), as well as Port |
+| X-Pack Security -> Username                   | Access -> User                    |                                                           |
+| X-Pack Security -> Password                   | Access -> Password                | Password must now be stored in a secret                   |
+| SSL Configuration -> Client Private Key       | SSL -> Client Key                 | Key must now be stored in a secret                        |
+| SSL Configuration -> Client Certificate       | SSL -> Client Cert                | Certificate must now be stored in a secret                |
+| SSL Configuration -> Client Key Password      | SSL -> Client Key Pass            | Password must now be stored in a secret                   |
+| SSL Configuration -> Enabled SSL Verification | SSL -> Certificate Authority File | Certificate must now be stored in a secret                |
+
+
+In legacy logging, indices were automatically created according to the format in the "Index Patterns" section. In v2.5 logging, default behavior has been changed to logging to a single index. You can still configure index pattern functionality on the output object by editing as YAML and inputting the following values:
+
+```
+...
+spec:
+  elasticsearch:
+    ...
+    logstash_format: true
+    logstash_prefix: <desired prefix>
+    logstash_dateformat: "%Y-%m-%d"
+```
+
+Replace `<desired prefix>` with the prefix for the indices that will be created. In legacy logging, this defaulted to the name of the cluster.
+
+## Splunk
+
+| Legacy Logging                           | v2.5+ Logging                          | Notes                                                                                  |
+|------------------------------------------|----------------------------------------|----------------------------------------------------------------------------------------|
+| HEC Configuration -> Endpoint            | Target -> Host                         | Protocol (https/http) and port must be defined separately from the host                |
+| HEC Configuration -> Token               | Access -> Token                        | Token must now be stored as a secret                                                   |
+| HEC Configuration -> Index               | Edit as YAML -> `index`                | `index` field must be added as YAML key under `spec.splunkHec`                         |
+| HEC Configuration -> Source              | Edit as YAML -> `source`               | `source` field must be added as YAML key under `spec.splunkHec`                        |
+| SSL Configuration -> Client Private Key  | Edit as YAML -> `client_key`           | `client_key` field must be added as YAML key under `spec.splunkHec`. See (1)           |
+| SSL Configuration -> Client Certificate  | Edit as YAML -> `client_cert`          | `client_cert` field must be added as YAML key under `spec.splunkHec`. See (1)          |
+| SSL Configuration -> Client Key Password | _Not Supported_                        | Specifying a password for the client private key is not currently supported.           |
+| SSL Configuration -> SSL Verify          | Edit as YAML -> `ca_file` or `ca_path` | `ca_file` or `ca_path` field must be added as YAML key under `spec.splunkHec`. See (2) |
+
+_(1) `client_key` and `client_cert` values must be paths to the key and cert files, respectively. These files must be mounted into the `rancher-logging-fluentd` pod in order to be used._
+
+_(2) Users can configure either `ca_file` (a path to a PEM-encoded CA certificate) or `ca_path` (a path to a directory containing CA certificates in PEM format). These files must be mounted into the `rancher-logging-fluentd` pod in order to be used._
+
+## Kafka
+
+| Legacy Logging                          | v2.5+ Logging              | Notes                                                |
+|-----------------------------------------|----------------------------|------------------------------------------------------|
+| Kafka Configuration -> Endpoint Type    | -                          | Zookeeper is no longer supported as an endpoint type |
+| Kafka Configuration -> Endpoint         | Target -> Brokers          | Comma-separated list of brokers (host:port)          |
+| Kafka Configuration -> Topic            | Target -> Default Topic    |                                                      |
+| SSL Configuration -> Client Private Key | SSL -> SSL Client Cert     | Certificate must be stored as a secret               |
+| SSL Configuration -> Client Certificate | SSL -> SSL Client Cert Key | Key must be stored as a secret                       |
+| SSL Configuration -> CA Certificate PEM | SSL -> SSL CA Cert         | Certificate must be stored as a secret               |
+| SASL Configuration -> Username          | Access -> Username         | Username must be stored in a secret                  |
+| SASL Configuration -> Password          | Access -> Password         | Password must be stored in a secret                  |
+| SASL Configuration -> Scram Mechanism   | Access -> Scram Mechanism  | Input mechanism as string, e.g. "sha256" or "sha512" |
+
+## Fluentd
+
+As of v2.5.2, it is only possible to add a single Fluentd server using the "Edit as Form" option. To add multiple servers, edit the output as YAML and input multiple servers.
+
+| Legacy Logging                           | v2.5+ Logging                                       | Notes                                                                |
+|------------------------------------------|-----------------------------------------------------|----------------------------------------------------------------------|
+| Fluentd Configuration -> Endpoint        | Target -> Host, Port                                | Input the host and port separately                                   |
+| Fluentd Configuration -> Shared Key      | Access -> Shared Key                                | Shared key must be stored as a secret                                |
+| Fluentd Configuration -> Username        | Access -> Username                                  | Username must be stored as a secret                                  |
+| Fluentd Configuration -> Password        | Access -> Password                                  | Password must be stored as a secret                                  |
+| Fluentd Configuration -> Hostname        | Edit as YAML -> `host`                              | `host` field set as YAML key under `spec.forward.servers[n]`         |
+| Fluentd Configuration -> Weight          | Edit as YAML -> `weight`                            | `weight` field set as YAML key under `spec.forward.servers[n]`       |
+| SSL Configuration -> Use TLS             | -                                                   | Do not need to explicitly enable. Define client cert fields instead. |
+| SSL Configuration -> Client Private Key  | Edit as YAML -> `tls_private_key_path`              | Field set as YAML key under `spec.forward`. See (1)                  |
+| SSL Configuration -> Client Certificate  | Edit as YAML -> `tls_client_cert_path`              | Field set as YAML key under `spec.forward`. See (1)                  |
+| SSL Configuration -> Client Key Password | Edit as YAML -> `tls_client_private_key_passphrase` | Field set as YAML key under `spec.forward`. See (1)                  |
+| SSL Configuration -> SSL Verify          | Edit as YAML -> `tls_insecure_mode`                 | Field set as YAML key under `spec.forward`. Default: `false`         |
+| SSL Configuration -> CA Certificate PEM  | Edit as YAML -> `tls_cert_path`                     | Field set as YAML key under `spec.forward`. See (1)                  |
+| Enable Gzip Compression                  | -                                                   | No longer supported in v2.5+ logging                                 |
+
+_(1) These values are to be specified as paths to files. Those files must be mounted into the `rancher-logging-fluentd` pod in order to be used._
+
+## Syslog
+
+As of v2.5.2, syslog is not currently supported as an output using v2.5+ logging. 
+
+## Custom Log Fields
+
+In order to add custom log fields, you will need to add the following YAML to your flow configuration:
+
+```
+...
+spec:
+  filters:
+    - record_modifier:
+        records:
+        - foo: "bar"
+```
+
+(replace `foo: "bar"` with custom log fields you wish to add)
+
+# System Logging
+
+In legacy logging, collecting logs from system components was accomplished by checking a box labeled "Include System Log" when setting up cluster logging. In v2.5+ logging, system logs are gathered in one of two ways:
+
+1. Gather all cluster logs, not specifying any match or exclusion rules. This results in all container logs from the cluster being collected, which includes system logs. 
+2. Specifically target system logs by adding match rules for system components. Specific match rules depend on the component being collected. 
\ No newline at end of file