<iframe src="https://youtu.be/b0LuhOEFKfU" ></iframe> # Grafana Cloud Integration This integration lets bots send metric events to [Grafana Cloud](https://grafana.com/products/cloud/) for additional observability. ## [View a Video Walkthrough of the integration here](https://youtu.be/b0LuhOEFKfU) These events can be used for: 1. Tracking custom metrics such as workflow completion or automation successes 2. Breaking down usage metrics by channel. 3. Viewing usage data in real-time 4. Monitoring chatbot performance over time, such as response latency, user drop-offs, and error rates For an overview of Grafana HTTP APIs for metrics, check out [this blog post](https://grafana.com/blog/2024/03/21/how-to-use-http-apis-to-send-metrics-and-logs-to-grafana-cloud/). The integration **does not add any metrics automatically**; instead, you must manually add either of the two action cards throughout your bot to record events. The two actions are: ### Send Metric This action pre-configures event metadata to include: * Channel (web, WhatsApp, etc.) * BotId * ConversationId * UserId * Bot Version The only data that needs to be added to this card is a custom name for the metric. The name can be anything, as long as it does not contain any whitespace. This card is useful for quickly recording metric-related events. ### Send Raw Data Advanced users can define their own custom Prometheus string, minus the timestamp. For example, this records a metric called "conv_end" with a value of 1 and metadata botId and choice: `conv_end,botId=demoBot,choice= metric=1` **Metric strings cannot contain whitespace!** The above example **will** cause errors if `event.preview` contains whitespace. Be cautious and preprocess any strings before sending them as metrics. ## Configuration Three pieces of information are needed to configure this integration, all of which are available when you add an HTTP Metrics data connection to your Grafana instance here: https://<YOUR_ORG>.grafana.net/connections/add-new-connection/http-metrics ### API Key This is a scoped API token that has write permissions on metrics, logs, and traces. It is different from the API key used to export metrics. ### User ID This is a 7-digit number unique to your Grafana instance. You can get it from the code sample at the bottom of the 'Add connection' page. ### Endpoint URL This is the server address where you push metrics. Make sure it starts with `influx-`. You can get it from the code sample at the bottom of the 'Add connection' page. ## Exporting Metrics The Grafana free tier only retains metrics and logs for 14 days. You can pull your metrics data out of Grafana using the shell script in the repository root. ## About the author This integration is created and maintained by Gordy from [Hanakano Consulting](https://www.hanakano.com). It is available [open-source on Github here](https://github.com/Gordon-BP/bp-grafana/tree/main). Pull requests are welcome!
