Edit of asset "grafana-cloud-connector" Accepted
Old/Current | New/Edit | |
---|---|---|
Title | grafana-cloud-connector | grafana-cloud-connector |
Description |
A tool for sending metrics and logs from Godot, into Grafana Cloud. Detailed setup instructions available at: https://github.com/KurzweilTV/godot-grafana-connector Setup Grafana Cloud You'll need a Grafana Cloud account. If you don’t have one, you can sign up here. Once logged in, navigate to Connections on the left, then follow the instructions below depending on whether you want to send Metrics or Logs. Metrics Setup From the Add New Connection screen, choose HTTP Metrics (Custom Data). For Metrics Format, choose Prometheus. Generate an API Key. Copy the URL, USER_ID, and API_KEY to use in the Godot script. Note: You might find this easier if you choose the Python option. Logs Setup From the Add New Connection screen, choose Logs Onboarding (Custom Data). Choose Collect, store, and manage logs in Grafana Cloud. Choose Logs HTTP. Generate an API Key. Copy the URL, USER_ID, and API_KEY to use in the Godot script. Note: You might find this easier if you choose the Python option. Godot Integration Once you download the plugin, place it in res://addons/grafana_cloud_connector/. Note: The download includes an optional examples/ folder containing a test scene to verify that your setup is working. Enable the Plugin From the menu bar, choose Project -> Project Settings, then click the Plugins tab. Enable the plugin, then restart Godot (or reload your project). The plugin should now be enabled. Script Configuration You'll need to add the information you copied from Grafana Cloud into the loki.gd and prometheus.gd scripts located at res://addons/grafana_cloud_connector/scripts/. In these scripts, you can also configure the game_name, which will be added as a label to every metric/log, helping you organize your data in Grafana. Usage Metrics To send a metric from anywhere in your project, use: Grafana.prometheus.send_metric("metric_name", 123, {"Optional": "Labels"}) metric_name (string) and metric (float) are required. Labels are optional but help in organizing your data in Grafana. Logs To send log lines from anywhere in your project, use: Grafana.loki.send_log("log line goes here", "level", {"Optional": "Labels"}) log line is required. level and labels are optional, but it's recommended to add a log level for automatic categorization in Grafana. Recognized Log Levels: "debug" "info" "warning" "error" Auto Instrumentation The plugin includes a scene for automatically collecting metrics globally from the engine. Add the scene located at res://addons/grafana_cloud_connector/scenes/MetricsCollector.tscn anywhere in your project. Once configured, performance metrics will be sent to Grafana every minute. |
A tool for sending metrics and logs from Godot, into Grafana Cloud. Detailed setup instructions available at: https://github.com/KurzweilTV/godot-grafana-connector |
Category | Tools | Tools |
License | MIT | MIT |
Repository Provider | GitHub | GitHub |
Repository Url | https://github.com/KurzweilTV/godot-grafana-connector | https://github.com/KurzweilTV/godot-grafana-connector |
Issues Url | https://github.com/KurzweilTV/godot-grafana-connector/issues | https://github.com/KurzweilTV/godot-grafana-connector/issues |
Godot version | Godot 4.0 | Godot 4.0 |
Version String | 1.0 | 1.0 |
Download Commit | d857936c46eb6cdb9d3f7f222b1c68f308013802 | d857936c46eb6cdb9d3f7f222b1c68f308013802 |
Download Url (Computed) | https://github.com/KurzweilTV/godot-grafana-connector/archive/d857936c46eb6cdb9d3f7f222b1c68f308013802.zip | https://github.com/KurzweilTV/godot-grafana-connector/archive/d857936c46eb6cdb9d3f7f222b1c68f308013802.zip |
Icon Url |
https://raw.githubusercontent.com/KurzweilTV/godot-grafana-connector/refs/heads/main/icon.png
|
https://raw.githubusercontent.com/KurzweilTV/godot-grafana-connector/refs/heads/main/icon.png
|
Preview Insert | ||
---|---|---|
Type | image | |
Image/Video URL |
https://i.ibb.co/f28tShk/autometrics.png
|
|
Thumbnail |
https://i.ibb.co/Y3D8Wzc/autometrics.png
|