{"id":28298499,"url":"https://github.com/sift-stack/sift-grafana-datasource","last_synced_at":"2026-02-13T02:17:04.193Z","repository":{"id":294942736,"uuid":"987236670","full_name":"sift-stack/sift-grafana-datasource","owner":"sift-stack","description":"This is a Grafana datasource plugin for Sift. It allows you to query Sift for data and visualize it in Grafana dashboards. The plugin supports both simple channel queries and calculated channel expressions.","archived":false,"fork":false,"pushed_at":"2025-12-16T22:24:22.000Z","size":1831,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-20T08:57:28.929Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sift-stack.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-20T19:22:48.000Z","updated_at":"2025-12-16T22:22:34.000Z","dependencies_parsed_at":"2025-06-07T00:23:14.822Z","dependency_job_id":"8787e856-6137-4e98-bd04-7cf1ce306bd5","html_url":"https://github.com/sift-stack/sift-grafana-datasource","commit_stats":null,"previous_names":["sift-stack/sift-grafana-datasource"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/sift-stack/sift-grafana-datasource","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sift-stack%2Fsift-grafana-datasource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sift-stack%2Fsift-grafana-datasource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sift-stack%2Fsift-grafana-datasource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sift-stack%2Fsift-grafana-datasource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sift-stack","download_url":"https://codeload.github.com/sift-stack/sift-grafana-datasource/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sift-stack%2Fsift-grafana-datasource/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28844011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T07:39:25.367Z","status":"ssl_error","status_checked_at":"2026-01-28T07:39:24.487Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-23T06:14:08.208Z","updated_at":"2026-02-13T02:17:04.186Z","avatar_url":"https://github.com/sift-stack.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sift Grafana Datasource\n\n[![Grafana 11](https://img.shields.io/badge/Grafana-11.0.0%2B-orange)](https://grafana.com)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/sift-stack/sift-grafana-datasource)](https://github.com/sift-stack/sift-grafana-datasource/releases)\n\n## Overview\n\nThis is a Grafana datasource plugin for [Sift](https://www.siftstack.com/). It allows you to query Sift for data and visualize it in Grafana dashboards. The plugin supports both simple channel queries and calculated channel expressions.\n\n\u003cimg alt=\"Grafana Query Screenshot - Channel Query\" src=\"https://raw.githubusercontent.com/sift-stack/sift-grafana-datasource/main/src/img/channel-query.png\" width=\"400\"\u003e\n\n\u003cimg alt=\"Grafana Query Screenshot - Calculated Channel Query\" src=\"https://raw.githubusercontent.com/sift-stack/sift-grafana-datasource/main/src/img/calculated-query.png\" width=\"400\"\u003e\n\n## Compatibility\n\nThis plugin is compatible with Grafana versions `11.0.0` and above.\n\n## User Guide\n\n### Configuration\n\nTo configure the plugin, you will need:\n\n1. The Sift REST API endpoint URL\n2. A valid Sift API key\n\nInstructions for getting these values can be found in the [Sift documentation](https://docs.siftstack.com/docs/api/how-to-guides/rest/authenticate-with-the-rest-api).\nEnter these values when creating the datasource in Grafana.\n\n### Usage\n\n1. Create a dashboard and add a panel\n2. Select the Sift data source\n3. Click \"Add Query\" and select either a Channel or Calculated Channel query\n4. Configure query\n5. Query will be run after selection or clicking outside the input or by clicking the Refresh button\n6. Additional Queries can be added using the \"Add Query\" button to use both Channel and Calculated Channel queries in the same panel\n\n#### Selection Types\n\nSelection of Assets, Runs, and Channels can be done using multiple different input types. Input type may be changed using the \"Change input type\" button.\n\n- **Selection**: Select from a list of options. Filter down the list by entering a search term. Only 200 will be shown at a time and a search may be required to find a specific option.\n- **Text**: Enter the exact name of the Asset, Run, or Channel. This will only return exact matches.\n- **ID/Client Key**: Enter the ID or Client Key of the Asset, Run, or Channel.\n- **Regex**: Enter a regular expression to find multiple Assets, Runs, or Channels by their name. This may return multiple matches. By default, the query is a substring match.\n- **Grafana Variable Selection**: Only available for Assets. Provides a list of Grafana dashboard variables that are Sift Asset Query variables (See below).\n\nChannels and Runs can only use the Selection type when an Asset option has been selected using the Selection dropdown.\n\n#### Grouping\n\nBy default, data is combined from multiple Runs into a single trace. To group by Channel and Run , uncheck \"Combine Runs\".\n\n#### Asset Query Variables\n\nQuery variables can be used to dynamically select Assets.\n\nTo add an Asset selector to your dashboard:\n\n1. Go to the Dashboard settings\n2. Click the \"Variables\" tab\n3. Click \"New Variable\" button\n4. Select variable type \"Query\"\n5. Select Data Source \"Sift\"\n6. Configure remaining options to your preference\n\nThe dashboard variable will allow for selecting Multiple, All, or a single Asset. The variable can be selected from the\ndashboard variable selector in the query editor for Asset.\n\n#### Other Dashboard Variables\n\nOther dashboard variables can be in any text input field such as name, ID, calculated channel name, or expression.\n\nTo use a dashboard variable in a query, enter the name as: `${variableName}`. The variable will be replaced with\nthe string value of the variable when the query is executed.\n\n#### Caching\n\nTo improve performance, queries are cached by panel for a given query and associated interval (sample rate). If the\nquery range changes, but the query is otherwise the same, only the missing data on either side will be fetched. In the case\nwhere the right side of the query range is close to live, new data will always be queried for data between now and the last 10 minutes.\n\nAsset, Run, and Channel queries are cached to speed up regular expression queries. These caches will expire after 10 minutes.\n\nBoth caches may be cleared for a panel by clicking the \"Clear cache\" button next to the Query Mode selector.\n\n#### Annotations\n\nAnnotations are supported and enable querying Sift Annotations or using regular Sift data queries to visualize data, such as enum state changes, as annotations.\n\n## Learn More\n\n- [Sift](https://www.siftstack.com/)\n- [Sift Documentation](https://docs.siftstack.com/)\n- [Sift Grafana Datasource Repository](https://github.com/sift-stack/sift-grafana-datasource)\n\n## Contributing\n\nPlease submit bug reports and pull requests to the [Sift Grafana Datasource](https://github.com/sift-stack/sift-grafana-datasource) repository on GitHub.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsift-stack%2Fsift-grafana-datasource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsift-stack%2Fsift-grafana-datasource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsift-stack%2Fsift-grafana-datasource/lists"}