Skip to content

Commit

Permalink
Merge pull request #550 from stakater/thunef/grafana-docs
Browse files Browse the repository at this point in the history
Update docs for grafana cloud monitoring
  • Loading branch information
thunef authored Nov 3, 2023
2 parents 7b8aa5d + 0c24e38 commit f69800e
Show file tree
Hide file tree
Showing 3 changed files with 47 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ Currently we support the following monitors:
- [Updown](https://updown.io/) ([Additional Config](docs/updown-configuration.md))
- [Application Insights](https://docs.microsoft.com/en-us/azure/azure-monitor/app/monitor-web-app-availability) ([Additional Config](docs/appinsights-configuration.md))
- [gcloud](https://cloud.google.com/monitoring/uptime-checks) ([Additional Config](docs/gcloud-configuration.md))
- [Grafana](https://grafana.com/grafana/plugins/grafana-synthetic-monitoring-app/) ([Additional Config](docs/grafana-configuration.md))

## Usage

Expand Down
46 changes: 46 additions & 0 deletions docs/grafana-configuration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Grafana Configuration

You can configure Grafana Synthetic Monitoring as an Ingress Monitor by using the configuration below:

| Key | Description |
| ------------- | ------------------------------------------------------------------------------------ |
| name | Name of the provider (e.g., Grafana) |
| apiKey | Synthetic monitoring access token |
| grafanaConfig | `grafanaConfig` is the configuration specific to Grafana instance as mentioned below:|

## Synthectic Monitoring Access Token
To obtain an access token for synthetic monitoring, first enable synthetic monitoring in your Grafana Cloud account. Then, navigate to the Configuration tab and generate a new token there.
![Generating access token](./grafana_docs_1.png)

## gcloud Configuration:

| Key | Description |
| --------- | ---------------------------------------------------------------- |
| frequency | How frequently the check should run (in milliseconds). |


**Example Configuration:**

```yaml
providers:
- name: Grafana
apiKey: <ACCESS TOKEN>
apiURL: https://synthetic-monitoring-api-eu-north-0.grafana.net
grafanaConfig:
frequency: 5000
enableMonitorDeletion: true
```
## Example Kubernetes Manifest:
```yaml
apiVersion: endpointmonitor.stakater.com/v1alpha1
kind: EndpointMonitor
metadata:
name: stakater
spec:
forceHttps: true
url: https://stakater.com/
gcloudConfig:
frequency: 5000
```
Binary file added docs/grafana_docs_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit f69800e

Please sign in to comment.