This repository was archived by the owner on Mar 14, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 29
added new example grafana dashboard #15
Merged
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,57 +1,44 @@ | ||
| # Grafana Dashboard | ||
|
|
||
| The `NGINX Mesh Top` Grafana dashboard provides a high-level picture | ||
| of the request volume and success rate of all your applications in the mesh. | ||
| NGINX Service Mesh deploys Grafana and adds `NGINX Mesh Top` as the | ||
| default dashboard. If you prefer to use an existing Grafana deployment, you can import | ||
| the `NGINX Mesh Top` dashboard included in this directory. | ||
| Two Grafana dashboards have been included as examples for use in your environment: | ||
| - NGINX Mesh Top | ||
| - NGINX Service Mesh Summary | ||
|
|
||
| Both Grafana dashboards provide a high-level picture of the request volume and success rate of all your applications in the mesh, and each have been included to provide two different references for consuming and rendering NGINX Service Mesh metrics data. | ||
|
|
||
| NGINX Service Mesh deploys Grafana and adds `NGINX Mesh Top` as the default dashboard. If you prefer to use an existing Grafana deployment, you can import either or both example dashboards included in this directory. | ||
|
|
||
| ## Prerequisties | ||
| - Grafana version >= 5.2.0 | ||
| - Prometheus datasource must be | ||
| [configured](https://prometheus.io/docs/visualization/grafana/#creating-a-prometheus-data-source). | ||
| - Prometheus datasource must be [configured](https://prometheus.io/docs/visualization/grafana/#creating-a-prometheus-data-source). | ||
|
|
||
| **Note:** If you are using the Prometheus server deployed by NGINX Service Mesh you can | ||
| find the address by running [`nginx-meshctl | ||
| config`](https://docs.nginx.com/nginx-service-mesh/reference/nginx-meshctl/#usage). | ||
| If you are using your own Prometheus server, make sure to add the NGINX | ||
| Service Mesh [scrape config](../prometheus/README.md) to your | ||
| Prometheus configuration. | ||
|
|
||
| **Note:** If you are using the Prometheus server deployed by NGINX Service Mesh you can find the address by running [`nginx-meshctl config`](https://docs.nginx.com/nginx-service-mesh/reference/nginx-meshctl/#usage). | ||
| If you are using your own Prometheus server, make sure to add the NGINX Service Mesh [scrape config](../prometheus/README.md) to your Prometheus configuration. | ||
|
|
||
| ## Installing the NGINX Mesh Top Dashboard | ||
| ## Installing Example Dashboards | ||
|
|
||
| To install the NGINX Mesh Top Dashboard using the Grafana UI follow these steps: | ||
| To install an example dashboard using the Grafana UI follow these steps: | ||
| - Select the New Dashboard button and click Import. | ||
| - Upload the [nginx-mesh-top.json](nginx-mesh-top.json) file or copy and paste the contents of the file in the textbox and click Load. | ||
| - Select the Prometheus data source you configured previously from the dropdown | ||
| menu and click Import. | ||
| - Upload the dashboard JSON, ex: [nginx-mesh-top.json](nginx-mesh-top.json), file or copy and paste the contents of the file in the textbox and click Load. | ||
| - Select the Prometheus data source you configured previously from the dropdown menu and click Import. | ||
|
|
||
|  | ||
|
|
||
|
|
||
| ### Features | ||
| NGINX Mesh Top dashboard includes the following stats and graphs: | ||
| The default NGINX Mesh Top dashboard includes the following stats and graphs: | ||
|
|
||
| - Stats: | ||
| - Global Success Rate: the percentage of requests that are successful over | ||
| the last 30 seconds (`nginxplus_upstream_server_responses` with response codes of `1xx` or `2xx`). | ||
| - Global Request Volume: the volume of requests over the last 30 seconds, | ||
| measured in requests per second (`nginxplus_http_total_requests`) . | ||
| - Global Success Rate: the percentage of requests that are successful over the last 30 seconds (`nginxplus_upstream_server_responses` with response codes of `1xx` or `2xx`). | ||
| - Global Request Volume: the volume of requests over the last 30 seconds, measured in requests per second (`nginxplus_http_total_requests`) . | ||
| - Pods Monitored: The number of pods being scraped by Prometheus. | ||
| - Graphs: | ||
| - Request Volume: this graph shows the volume of requests per Pod, in | ||
| requests per second (`nginxplus_http_total_requests`). | ||
| - Pod Success: this graph shows the percentage of requests that are | ||
| successful per Pod (`nginxplus_upstream_server_responses` with response codes of | ||
| `1xx` or `2xx`). | ||
| - Request Volume: this graph shows the volume of requests per Pod, in requests per second (`nginxplus_http_total_requests`). | ||
| - Pod Success: this graph shows the percentage of requests that are successful per Pod (`nginxplus_upstream_server_responses` with response codes of `1xx` or `2xx`). | ||
| - Sidecar Memory Usage (RSS): this graph shows the Resident Set Size (RSS) of the NSM sidecars. | ||
| - Sidecar Memory Usage (Private): this graph shows the Private memory used by the NSM sidecars. | ||
|
|
||
kate-osborn marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| ## Customizing your own Dashboard | ||
|
|
||
| NGINX Service Mesh exposes NGINX Plus metrics in Prometheus format that can be used to | ||
| create your own panels and custom dashboards. For a list of available metrics, labels, | ||
| and example Prometheus queries, see the [Traffic Metrics | ||
| guide](https://docs.nginx.com/nginx-service-mesh/guides/traffic-metrics/). | ||
| NGINX Service Mesh exposes NGINX Plus metrics in Prometheus format that can be used to create your own panels and custom dashboards. For a list of available metrics, labels, and example Prometheus queries, see the [Traffic Metrics guide](https://docs.nginx.com/nginx-service-mesh/guides/traffic-metrics/). | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.