DE 

//Cloudogu EcoSystem Docs

  1. docs.cloudogu.com
  2. Developer documentation
  3. Dogus
  4. Grafana
  5. Functions
  6. Configuration of the Grafana-Dogus
Getting Started
User manual
Developer documentation

Configuration of the Grafana-Dogus

Authorizations

A user in the global admin group (key: config/_global/admin_group) has full admin access to the Dogu at all times. In addition, various roles can be created in the configuration:

  • config/grafana/reader_group: The group set there has read permissions in Grafana (Viewer)

    • If the key is not set, the group grafanaReader automatically receives this authorization.

  • config/grafana/writer_group: The group set there has write permissions in Grafana (Editor)

    • If the key is not set, the group grafanaWriter automatically receives this authorization.

  • config/grafana/admin_group: The group set there has admin authorizations in Grafana (Admin)

    • If the key is not set, the group grafanaAdmin automatically receives this authorization.

If you are not in any of the groups mentioned, you cannot access Grafana at all.

Gravatar

The configuration key config/grafana/disable_gravatar can be used to deactivate Gravatar for Grafana.

  • "true": Gravatar is deactivated.
  • "false": Gravatar is enabled.
  • no value: Gravatar is enabled.

Backup notifications

Grafana Dogu sends email notifications about the success/failure of backups and restores. The content of these notifications can be configured via the Dogu configuration. The mail templates can be written as text or HTML .

Depending on the resource, various variables are available that can be included in the notification template. They can be used as follows.

{{ (index .Alerts 0).Annotations.<Name of variable> }}
Configuration key Description Default value Variables
alerts/backup_completed/subject The subject line of the email notification sent when a backup has been successfully completed. Backup abgeschlossen name: the name of the backup
alerts/backup_completed/body The text of the email notification sent when a backup has been successfully completed. Das Backup {{ (index .Alerts 0).Annotations.name }} der Instanz {{ reReplaceAll "grafana/" "" .ExternalURL }} wurde erfolgreich abgeschlossen. name: the name of the backup; .ExternalURL: external URL to Grafana-Dogu (reReplaceAll removes the path grafana/)
alerts/backup_failed/subject The subject line of the email notification sent when a backup has failed. Backup fehlgeschlagen name: the name of the backup
alerts/backup_failed/body The text of the email notification sent when a backup has failed. Das Backup {{ (index .Alerts 0).Annotations.name }} der Instanz {{ reReplaceAll "grafana/" "" .ExternalURL }} ist fehlgeschlagen. name: the name of the backup; .ExternalURL: external URL to Grafana-Dogu (reReplaceAll removes the path grafana/)
alerts/restore_completed/subject The subject line of the email notification sent when a backup has been successfully restored. Backup wiederherstellen abgeschlossen backupname_: the name of the backup that was restored
alerts/restore_completed/body The text of the email notification that is sent when a backup has been successfully restored. Das Wiederherstellen des Backups {{ (index .Alerts 0).Annotations.backup_name }} der Instanz {{ reReplaceAll "grafana/" "" .ExternalURL }} wurde erfolgreich abgeschlossen. backupname: the name of the backup that was restored; _.ExternalURL: external URL to Grafana-Dogu (reReplaceAll removes the path grafana/)
alerts/restore_failed/subject The subject line of the email notification that is sent when a backup has failed to restore. Backup wiederherstellen fehlgeschlagen backupname_: the name of the backup that was restored
alerts/restore_failed/body The text of the email notification that is sent when a backup has failed to restore. Das Wiederherstellen des Backups {{ (index .Alerts 0).Annotations.backup_name }} der Instanz {{ reReplaceAll "grafana/" "" .ExternalURL }} ist fehlgeschlagen. backupname: the name of the backup that was restored; _.ExternalURL: external URL to Grafana-Dogu (reReplaceAll removes the path grafana/)
alerts/receiver_emails Semicolon speparated list of receivers. ces@cloudogu.invalid;admin@cloudogu.invalid