{"id":15687146,"url":"https://github.com/sd2k/grafana-materialize-datasource","last_synced_at":"2025-05-07T19:09:44.100Z","repository":{"id":40508059,"uuid":"467850359","full_name":"sd2k/grafana-materialize-datasource","owner":"sd2k","description":"A Grafana datasource for the Materialize streaming SQL database.","archived":false,"fork":false,"pushed_at":"2023-03-15T04:26:28.000Z","size":3098,"stargazers_count":7,"open_issues_count":6,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T19:09:41.447Z","etag":null,"topics":["grafana-plugin","hacktoberfest","materialize","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/sd2k.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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}},"created_at":"2022-03-09T09:01:03.000Z","updated_at":"2025-04-15T08:08:14.000Z","dependencies_parsed_at":"2024-10-23T20:36:37.457Z","dependency_job_id":"46bb0e04-0303-42c5-8c89-fc0f1c5444ff","html_url":"https://github.com/sd2k/grafana-materialize-datasource","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sd2k%2Fgrafana-materialize-datasource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sd2k%2Fgrafana-materialize-datasource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sd2k%2Fgrafana-materialize-datasource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sd2k%2Fgrafana-materialize-datasource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sd2k","download_url":"https://codeload.github.com/sd2k/grafana-materialize-datasource/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252940934,"owners_count":21828769,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["grafana-plugin","hacktoberfest","materialize","rust"],"created_at":"2024-10-03T17:44:06.767Z","updated_at":"2025-05-07T19:09:44.011Z","avatar_url":"https://github.com/sd2k.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grafana Materialize Data Source\n\nThis is a Grafana data source which can connect to the [Materialize][] streaming SQL database. It supports the Grafana Live capabilities for streaming data and hence can be used to visualise data in materialized views 'live'.\n\n## Usage\n\n### Configuring the datasource\n\nOnly three parameters are available for the datasource:\n\n- **Host** - the hostname of the Materialize database\n- **Port** - the port on which to connect to the Materialize database\n- **Username** - the username as which to connect to the Materialize database\n\n### Querying the datasource\n\nWhen querying the datasource in a new panel you have two options available to you:\n\n- **Relation** - the query builder will populate a list of available relations in the Materialize database. Select one and the relation will be `TAIL`ed to the panel.\n- **Select statement** - input a custom statement into the query field and the output of the statement will be `TAIL`ed to the panel.\n\n### Configuring panels\n\nThe plugin includes the `mz_timestamp` and `mz_diff` columns in the streaming output, which may not be what you want to see. The simplest way to solve this is to use the [Transformations][] functionality of the panels. In the panel editor, click the **Transform** button and add any transformations you like. A good place to start is:\n\n1. Organize fields\n   Use this to hide the `mz_diff` field by clicking the 'eye' symbol next to the field name.\n2. Prepare time series\n   Select **Multi-frame time series** as the format.\n3. Rename by regex\n   Use this to remove any common unwanted prefix from the time series names. E.g. set **Match** to `avg (.*)` and **Replace** to `$1` to remove the prefix `avg `.\n\nSee the 'transforms' screenshot for an example.\n\n## Screenshots\n\nhttps://user-images.githubusercontent.com/5464991/166680691-8df200d7-e354-43bf-a924-8ce9fbc8582a.mov\n\n![image](https://raw.githubusercontent.com/sd2k/grafana-materialize-datasource/main/src/img/query.png)\n\n![image](https://raw.githubusercontent.com/sd2k/grafana-materialize-datasource/main/src/img/transforms.png)\n\n[Materialize]: https://materialize.com\n[Transformations]: https://grafana.com/docs/grafana/latest/panels/transform-data/transformation-functions/\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsd2k%2Fgrafana-materialize-datasource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsd2k%2Fgrafana-materialize-datasource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsd2k%2Fgrafana-materialize-datasource/lists"}