我的书签
添加书签
移除书签For background information about how logging integrations work, refer to the
Rancher supports the following services:
- Elasticsearch
- Splunk
- Kafka
- Syslog
- Fluentd
Only administrators, , or project owners can configure Rancher to send Kubernetes logs to a logging service.
The Docker daemon on each node in the cluster should be with the (default) log-driver: . You can check the log-driver by running the following command:
Setting up a logging service to collect logs from your cluster/project has several advantages:
- Logs errors and warnings in your Kubernetes infrastructure to a stream. The stream informs you of events like a container crashing, a pod eviction, or a node dying.
- Allows you to capture and analyze the state of your cluster and look for trends in your environment using the log stream.
- Helps you when troubleshooting or debugging.
- Saves your logs to a safe location outside of your cluster, so that you can still access them even if your cluster encounters issues.
You can configure logging at either cluster level or project level.
Cluster logging writes logs for every pod in the cluster, i.e. in all the projects. For , it also writes logs for all the Kubernetes system components.
Pod logs stored at .
Kubernetes system components logs stored at .
From the Global view, navigate to the project that you want to configure project logging.
Select Tools > Logging in the navigation bar. In versions before v2.2.0, you can choose Resources > Logging.
Select a logging service and enter the configuration. Refer to the specific service for detailed configuration. Rancher supports the following services:
(Optional) Instead of using the UI to configure the logging services, you can enter custom advanced configurations by clicking on Edit as File, which is located above the logging targets. This link is only visible after you select a logging service.
With the file editor, enter raw fluentd configuration for any logging service. Refer to the documentation for each logging service on how to setup the output configuration.
If the logging service is using TLS, you also need to complete the SSL Configuration form.
Provide the Client Private Key and Client Certificate. You can either copy and paste them or upload them by using the Read from a file button.
You can generate a self-signed certificate using an openssl command. For example:
If you are using a self-signed certificate, provide the CA Certificate PEM.
(Optional) Complete the Additional Logging Configuration form.
Optional: Use the Add Field button to add custom log fields to your logging configuration. These fields are key value pairs (such as ) that you can use to filter the logs from another system.
Enter a Flush Interval. This value determines how often flushes data to the logging server. Intervals are measured in seconds.
Include System Log. The logs from pods in system project and RKE components will be sent to the target. Uncheck it to exclude the system logs.
Click Test. Rancher sends a test log to the service.
Note: This button is replaced with Dry Run if you are using the custom configuration editor. In this case, Rancher calls the fluentd dry run command to validate the configuration.
Click Save.
