Prometheus
Prometheus provides a powerful solution for recording metrics, persisting them to a pluggable time series datastore, and querying them for both visualizations and alerting purposes. Metrics data is pulled from Fusion and stored in a time series datastore. For more information, see the Prometheus documentation.Grafana
Grafana provides an industry-standard metric visualization tool that supports complex visualizations over any number of different pluggable data sources, organized into panels and managed dashboards. Grafana connects Prometheus, allowing you to access your Fusion data when creating or editing panels in your dashboards. Pre-configured Grafana dashboards are provided with Fusion deployments. However, custom dashboards extend your metrics analysis capabilities.Managed Fusion offers read-only access for Grafana. If you are a Managed Fusion customer, you cannot create custom dashboards.
Loki
Loki is a log aggregation system designed to store and query logs. With Loki, you can define a log stream from Fusion’s namespaces, services, pods, and more. Then, you can filter the log stream for key data, such as keyword matches for “error.” For more information, see the Grafana’s Loki documentation.Setup and configuration
Prometheus and Grafana are enabled during Fusion installation, and Loki is an optional addition to the Prometheus and Grafana integration. For more information, see:- Configure Grafana, Prometheus, Promtail, and Loki in Fusion
Configure Grafana, Prometheus, Promtail, and Loki in Fusion
Configure Grafana, Prometheus, Promtail, and Loki in Fusion
Before you perform these installation instructions, you must delete any existing persistent volume claims (PVCs) related to Prometheus, Grafana, Promtail, and Loki on your namespace.
Clone the fusion-cloud-native repository
Open a terminal window and run following command:Install Grafana
-
In your local
fusion-cloud-nativerepository, run the following command for your<cluster>and<namespace>:The following is a sample output. The errors are related to resource limits on the sample cluster, and can be ignored. Similar errors may display for your cluster, and do not impact Grafana logging. -
Using the Grafana service endpoint in the newly-installed Grafana helm release, run the following command:
The following is a sample output.If the output does not display, run the following command to expose Grafana, including an
EXTERNAL_IPfor your Grafana LoadBalancer service:
Install Loki
To obtain Loki from the helm chart repository, run the following command for the unique<loki-release-name> for your cluster:<loki-release-name> correctly, an error similar to the following displays:Obtain Admin credentials for Grafana
-
After you validate Grafana is running by accessing
<EXTERNAL-IP>:3000, run the following command to obtain an<admin_password>for your Grafana instance: - Sign in to Grafana and change the password for security purposes.
-
Run the following command to display the promtail pods that are running:
Promtail pods must match the number of Kubernetes nodes since an instance of Promtail runs on each node.
Add the Loki datsource
- Sign in to Grafana and in the toolbar, click the arrow below Home to display all of the options.
- In the Configuration section, click Data sources.
- Click Add new data source.
- In the search bar for the data source, enter Loki.
-
In the URL field on the Settings screen, enter your unique
<loki-release-name:port>. The default port for Loki is3100.If you encounter issues with the<loki-release-name:port>information, open a terminal and runkubectl get services | grep lokito display a list of every service with a name that containslokialong with its associated IP address and port. - Complete the other fields and click Save & test.