Skip to Content

Changes for page Grafana

Last modified by Peter Wurbs on 2025/05/07 11:36
From version 12.1
edited by Peter Wurbs
on 2025/04/10 07:50
Change comment: There is no comment for this version
To version 26.2
edited by Peter Wurbs
on 2025/04/10 09:52
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -17,6 +17,8 @@
17 17  
18 18  [[Grafana Tutorials>>https://grafana.com/tutorials/?utm_source=grafana_gettingstarted]]
19 19  
20 +There is a great possibility to play with Grafana using the [[Grafana Playground>>https://play.grafana.org/d/bdnahipisghdsa/getting-started-with-grafana-play?orgId=1]].
21 +
20 20  = Accessing Grafana =
21 21  
22 22  * Grafana as part of the DevOps-as-a-Service toolchain can be accessed by either
... ... @@ -23,7 +23,9 @@
23 23  ** DevOps Portal Homepage ~-~-> Grafana Tile
24 24  [[image:1744266164249-840.png]]
25 25  ** or directly use the URL [[https:~~/~~/grafana-<customer~>.devops.t-systems.net>>https://grafana-<customer>.devops.t-systems.net]]
26 -* A Grafana license must be assigned to the user in the DevOps portal to see the Grafana tile resp. to get access to Grafana.
28 +* Preconditions in DevOps portal to access Grafana:
29 +** A Grafana license must be assigned to the user
30 +** Grafana must be added to the tool list of the project
27 27  * If you are not already logged in to another tool in the toolchain, then you have to login using your configured SSO credentials.
28 28  * When you see this message after entering your credentials, then you don't have a Grafana license assigned in the DevOps portal:
29 29  [[image:1744266590219-161.png||height="242" width="293"]]
... ... @@ -42,5 +42,88 @@
42 42  )))
43 43  * There is an additional permission management possible on folder level. A folder contains a set of dashboards. A project admin can create folders and manage specific permissions for this folder using Grafana. See this [[link >>https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/#create-a-dashboard-folder]]for further information. Folder permissions management is out of scope of the user management in the DevOps portal.
44 44  * A project admin is entitled to create and manage "Service Accounts" in Grafana and grant permissions in the specific organization. A Service Account belongs to an Organization (Project) and not to an user. Service Accounts can be used for systems which want to work wit the Grafana API for any automation purposes. See this [[link >>https://grafana.com/docs/grafana/latest/administration/service-accounts/]]for further information. Service Account management is done directly in Grafana and is out of scope of the user management in the DevOps portal.
49 +* If you are assigned to more than one project in the DevOps portal, having Grafana configured as tool, then you can switch between Organizations in Grafana. Go to the top left corner, click on the Org list and select any other Grafana Organization (project), you want to switch to.
50 +**When you work in Grafana, always make sure that you chose the intended Organization.**
51 +[[image:1744272203893-682.png||height="272" width="255"]]
45 45  
46 -
53 += Main Functions =
54 +
55 +== Datasources ==
56 +
57 +* Before you can setup dashboards and alerts, you have to setup datasources. Grafana itself is only a visualization tool, for data gathered via datasources.
58 +* Datasources are created/managed per Grafana Organization.
59 +* The Admin role is required to setup and manage datasources.
60 +
61 +(% class="box warningmessage" %)
62 +(((
63 +⚠ **Note**
64 +When a datasource is available in an Organization, every user assigned to this Organization (Project) with Admin or Edit role can access/explore the data provided by this datasource.
65 +)))
66 +
67 +* Most common datasources are configured for
68 +** Prometheus to visualize metrics
69 +** Loki to search and visualize logs
70 +** MySQL, PostgreSQL to access and visualize database data
71 +* Many possible datasource types are preinstalled as built-in plugins and can be used
72 +* Datasource are set up via Menu panel ~-~-> Connections ~-~-> Datasources
73 +[[image:1744273328067-517.png||height="273" width="222"]]
74 +* Detailed information can be found via this [[link>>https://grafana.com/docs/grafana/latest/datasources/]].
75 +
76 +== Explore ==
77 +
78 +* Based on set up datasources, users owning the Edit or Admin role can explore provided data using the "Explore" function.
79 +* "Explore" can be used for:
80 +** Check provided data, contained labels
81 +** Search for specific data
82 +** Quickly execute queries and generate visualization panels
83 +** Generate queries later to be used in dashboards
84 +* "Explore" function can be found in the Menu panel
85 +* Detailed information can be found via this [[link>>https://grafana.com/docs/grafana/latest/explore/]]
86 +
87 +== Dashboards ==
88 +
89 +* Dashboards are the way to visualize metrics, logs and other data.
90 +* Dashboards are a collection of "Panels". Each panel is of a specific type (stat, time series, table, log...). Many Panel Plugins are preinstalled and can be used.
91 +* Data are displayed based on queries which are the main part of a panel configuration.
92 +* Dashboards can be created and edited by users owning the Editor or Admin role
93 +* "Dashboard" function can be in the Menu panel
94 +* There is a good [[guideline >>https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/]]about the first steps.
95 +* Detailed information can be found via this [[link>>https://grafana.com/docs/grafana/latest/dashboards/build-dashboards/]].
96 +
97 +== Alerts ==
98 +
99 +* Based on the data gathered via datasources, alerts can be defined.
100 +* In contrast to the classic alerting, the new Grafana Unified Alerting is set up mostly independent of specific dashboards.
101 +* Alerting configuration is split into
102 +** Alert rules
103 +** Contact points
104 +** Notification policies
105 +* How it works
106 +** Grafana alerting periodically queries data sources and evaluates the condition defined in the alert rule
107 +** If the condition is breached, an alert instance fires
108 +** Firing instances are routed to notification policies based on matching labels
109 +** Notifications are sent out to the contact points specified in the notification policy
110 +** [[image:1744277362911-905.png||height="169" width="514"]]
111 +* Many contact point types like E-Mail, Teams, Slack, Pushover etc. are available and can be configured.
112 +* "Alerting" function can be in the Menu panel
113 +* Detailed information can be found via this [[link>>https://grafana.com/docs/grafana/latest/alerting/]].
114 +
115 += Metrics of DevOps-as-a-Service Toolchain =
116 +
117 +* As part of the Grafana deployment, preconfigured and standardized dashboards are provided to show relevant data about the DevOps-as-a-Service toolchain
118 +* These dashboards are located in the MainOrg.
119 +* To access them:
120 +** Switch to the MainOrg in the Org list on the top left corner.
121 +** Click on Dashboards in the left Menu pane
122 +** Click on folder "DevOps-as-a-Service Metrics"
123 +** Choose the dashboard you want to see
124 +** [[image:1744278056971-203.png||height="285" width="826"]]
125 +
126 +(% class="box infomessage" %)
127 +(((
128 +(% class="box warningmessage" %)
129 +(((
130 +⚠ **Note**
131 +Every user assigned a Grafana license in the DevOps portal is able to access them, independent of any project assignment.
132 +)))
133 +)))
1744272014208-216.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +16.0 KB
Content
1744272094885-491.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +17.2 KB
Content
1744272203893-682.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +17.2 KB
Content
1744273328067-517.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +15.9 KB
Content
1744277362911-905.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +30.0 KB
Content
1744278056971-203.png
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.peterwurbst-systemscom
Size
... ... @@ -1,0 +1,1 @@
1 +55.0 KB
Content
© 2018-2025 T-Systems International GmbH