Graphical metrics display module (shturval-dashboards)

About the service

ParameterDescription
GUI nameMetrics visualization module
System name (identifier)shturval-dashboards
Cluster AssignmentVisualization of metrics: dashboards for Kubernetes, Victoria Metrics, platform services. Access via the “Statistics” button on the cluster dashboard.
CriticalNo
Public repositoryGrafana
Dependencies—
Namespacemonitoring

Purpose

shturval-dashboards - metrics visualization module based on Grafana. Provides dashboards for Kubernetes, Victoria Metrics, and platform services. Access via the Statistics button on the cluster dashboard.

Features

  • Located in the management cluster;
  • SSO authorization when leaving the platform;
  • Pre-installed dashboards (API server, etcd, Kubelet, Compute Resources, etc.);
  • Support for custom dashboards via ConfigMap (provisioning).

Detailed descriptions of sets of panels by topic (Kubernetes, VictoriaMetrics, exporters, services) - Monitoring Dashboards.

Where to configure

Services and repositories → Installed services → find Graphical display of metrics module (shturval-dashboards) → Manage.

Changing the configuration (admin password, OAuth, root_url, etc.) - via ShturvalServicePatch for shturval-dashboards.

ShturvalServicePatch example: password and user Grafana
apiVersion: ops.shturval.tech/v1beta2
kind: ShturvalServicePatch
metadata:
  name: shturval-dashboards-access
spec:
  shturvalServiceConfigName: shturval-dashboards
  customvalues:
    adminUser: <your value>
    adminPassword: <your value>
ParameterDescriptionTypeExample
adminUserGrafana Account Namestringadmin
adminPasswordGrafana account passwordstringpassword
ShturvalServicePatch Example: OAuth and Access URL
apiVersion: ops.shturval.tech/v1beta2
kind: ShturvalServicePatch
metadata:
  name: shturval-dashboards-oauth
spec:
  shturvalServiceConfigName: shturval-dashboards
  customvalues:
    grafana.ini:
      auth.generic_oauth:
        api_url: <your value>
        auth_url: <your value>
        client_id: grafana
        client_secret: <your value>
        token_url: <your value>
      server:
        root_url: <your value>
    ingress:
      enabled: true
      hosts:
        - <your value>
ParameterDescriptionExample
auth.generic_oauth.api_urlURL to get OAuth2 user informationhttp://auth.shturval.tech/oauth/user_info
auth.generic_oauth.auth_urlOAuth2 Authorization URLhttp://auth.shturval.tech/oauth/authorize
auth.generic_oauth.client_secretOAuth2 Client SecretHG0rxJMKopmAGSasDxDtkJYQH
auth.generic_oauth.token_urlOAuth2 Token Retrieval URLhttp://auth.shturval.tech/oauth/token
server.root_urlURL to access Grafana from the browserdashboards.admin-manual.shturval
ingress.hostsIngress Host Listdashboards.admin-manual.shturval
Screenshot of the applied ShturvalServicePatch

Applied ShturvalServicePatch for shturval-dashboards

Access to Grafana

The Grafana interface is accessible by the dashboards prefix in the cluster domain, for example dashboards.clustername.ip-XX-XX-XX-XX.shturval.link. Login data is generated when the cluster is deployed and stored in Secret shturval-dashboards in namespace monitoring of the management cluster.

kubectl -n monitoring get secret shturval-dashboards -o go-template='{{ index .data "admin-user" | base64decode }}'
kubectl -n monitoring get secret shturval-dashboards -o go-template='{{ index .data "admin-password" | base64decode }}'

The Statistics button on the cluster dashboard is available if shturval-metrics-collector is enabled in the client cluster, and shturval-dashboards and shturval-monitoring are enabled in the management cluster).

When navigating from the Shturval platform to Grafana dashboards, an error 401 may occur. To access the dashboards, log back into the Grafana interface.

More details: Adding dashboards, Monitoring dashboards. Official documentation: Grafana.


How to deploy this service - How to deploy a new service.