/viya4-monitoring-kubernetes

Provides simple scripts and customization options to deploy monitoring, alerts, and log aggregation for Viya 4 running on Kubernetes

Primary LanguageShellApache License 2.0Apache-2.0

SAS® Viya® Monitoring for Kubernetes

SAS® Viya® Monitoring for Kubernetes provides simple scripts and customization options to deploy monitoring, alerts, and log aggregation for SAS Viya 4.

Monitoring and logging can be deployed independently or together. There are no hard dependencies between the two.

Monitoring - Metrics and Alerts

The monitoring solution includes these components and your right to use each such component is governed by its applicable open source license:

This is an example of a Grafana dashboard for cluster monitoring. Grafana - Cluster Monitoring

This is an example of a Grafana dashboard for SAS CAS monitoring. Grafana - SAS CAS Monitoring

See the documentation at SAS Viya: Monitoring for more information about using the monitoring components.

Logging - Aggregation, Searching, & Filtering

This is an example of OpenSearch Dashboards displaying log message volumes.

OpenSearch Dashboards - Log Message Volume Dashboard

For information about the application components deployed by the log-monitoring solution, the prerequisites, and more, see Getting Started in the SAS Viya Administration Help Center.

Installation

Monitoring

See the monitoring README to deploy the monitoring components, including Prometheus Operator, Prometheus, Alertmanager, Grafana, metric exporters, service monitors, and custom dashboards.

Logging

See the documentation at SAS Viya: Logging for information about deployment.

Customization

For most deployment scenarios, the process of customizing the monitoring and logging deployments consists of:

  • creating the location for your local customization files
  • using the USER_DIR environment variable to specify the location of the customization files
  • copying the customization files from one of the provided samples to your local directory
  • specifying customization variables and parameters in the customization files

Other scenarios use different customization steps that are specific to each scenario.

Samples are provided for several common deployment scenarios. Each sample includes detailed information about the customization process and values for the scenario.

See the monitoring README and SAS Viya: Logging for detailed information about the customization process and about determining valid customization values. See the README file for each sample for detailed information about customization for each deployment scenario.

Default StorageClass

The default cluster StorageClass is used for both monitoring and logging unless the value is overidden in the user-*.yaml files for monitoring or logging. The deployment scripts issue a warning if no default StorageClass is available, even if the value is properly set by the user. In this case, you can safely ignore the warning.