{"id":18044672,"url":"https://github.com/groonga/grafana-datasource-plugin-groonga","last_synced_at":"2025-10-18T07:34:11.728Z","repository":{"id":55948762,"uuid":"50635973","full_name":"groonga/grafana-datasource-plugin-groonga","owner":"groonga","description":"Groonga datasource plugin for Grafana","archived":false,"fork":false,"pushed_at":"2024-10-31T02:36:27.000Z","size":1188,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-10T01:08:11.349Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/groonga.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2016-01-29T03:54:56.000Z","updated_at":"2024-10-31T02:36:25.000Z","dependencies_parsed_at":"2023-12-18T23:25:35.420Z","dependency_job_id":"8e8e8b5c-cfc5-4c16-8edb-e5502702ba99","html_url":"https://github.com/groonga/grafana-datasource-plugin-groonga","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groonga%2Fgrafana-datasource-plugin-groonga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groonga%2Fgrafana-datasource-plugin-groonga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groonga%2Fgrafana-datasource-plugin-groonga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/groonga%2Fgrafana-datasource-plugin-groonga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/groonga","download_url":"https://codeload.github.com/groonga/grafana-datasource-plugin-groonga/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137887,"owners_count":21053775,"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":[],"created_at":"2024-10-30T18:10:15.021Z","updated_at":"2025-10-18T07:34:11.642Z","avatar_url":"https://github.com/groonga.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grafana Groonga Data Source Plugin\n\n![CI](https://github.com/groonga/grafana-datasource-plugin-groonga/workflows/CI/badge.svg)\n\nView report data from Groonga in your Grafana.\n\n## Install the Data Source\nUse the new grafana-cli tool to install groonga-datasource from the commandline:\n\n```bash\ngrafana-cli plugins install groonga-datasource\n```\n\nThe plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins if you installed the grafana package.\n\n## Configure the Data Source\n\nAccessed from the Grafana main menu, newly installed data sources can be added immediately within the `Data Sources` section.\nNext, click the `Add data source` button in the upper right. The data source will be available for selection in the Type select box.\nTo see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.\nSelect Groonga-datasource and enter the `Name`, `URL`, `Default table name`, and `Default field name` in the displayed setting screen.\n\n## How to try\n\nYou can use [docker-compose](https://docs.docker.com/compose/) to try\ngroonga-datasource. Here is a command line to try groonga-datasource\n1.1.4:\n\n```bash\nGF_GROONGA_DATASOURCE_DIR=/tmp/groonga-datasource \\\n  GF_INSTALL_PLUGINS=\"https://github.com/groonga/grafana-datasource-plugin-groonga/releases/download/1.1.4/groonga-datasource-1.1.4.zip;groonga-datasource\" \\\n  docker-compose up garafana\n```\n\nYou can find Grafana at http://localhost:3000/ .\n\nYou can login as the `admin` user with `admin` for password.\n\nYou can find \"Groonga\" datasource at the bottom of\nhttp://localhost:3000/datasources/new . You can use the following\nparameters to use the test Groonga server that has some test data:\n\n  * Name: `Groonga`\n  * HTTP\n    * URL: `http://groonga:10041/`\n  * Groonga Details\n    * Default table name: `Logs`\n    * Default time field name: `timestamp`\n\nYou can use the Groonga datasource in a panel with the following\nparameters:\n\n  * Table Name: `Logs`\n\nYou can see visualized data in the test Groonga server.\n\n## Usage\n\n- `Table Name`: target table name.\n- `Time field`: the key time field for the table.\n- `Output columns`: output columns by csv format. (ex: `timefield,value1,value2`)\n- `limit num`: number of output records. default value is `10`.\n- `Filter string`: filtering string according to [Groonga's script syntax](https://groonga.org/docs/reference/grn_expr/script_syntax.html).\n- `Sort columns`: sort key columns by csv format. (ex: `timefield,value1,-value2`)\n  - If you want to use descending order, add `-` at the beginning.)\n\nIf you want to perform aggregation processing, specify the following.\n- `Key columns`: Aggregate key columns by csv format.\n- `Type`: data aggregation method(count/sum/max/min/avg).\n- `Target`: column to be aggregated.\n- `Interval`: Interval when aggregation is performed for each fixed period.\n\n\u003e **Note:**\n\u003e - If you want to aggregate every certain period in the graph panel, `Interval` is required.\n\u003e - Aggregated time is stored in a column called AGGTIME and can be used in Key columns and Output columns.\n\u003e - If you want to display aggregated values, specify a special column name in Output columns.\n\u003e\n\u003e |Aggregation method|Special column name|\n\u003e |---|---|\n\u003e |count|_nsubrecs|\n\u003e |sum|_sum|\n\u003e |max|_max|\n\u003e |min|_min|\n\u003e |avg|_avg|\n\n\u003e **Limitations:**\n\u003e - If multiple queries are used, the settings of the first query will be valid except for the aggregated items.\n\n## Learn more\n- [Build a data source plugin tutorial](https://grafana.com/tutorials/build-a-data-source-plugin)\n- [Grafana documentation](https://grafana.com/docs/)\n- [Grafana Tutorials](https://grafana.com/tutorials/) - Grafana Tutorials are step-by-step guides that help you make the most of Grafana\n- [Grafana UI Library](https://developers.grafana.com/ui) - UI components to help you build interfaces using Grafana Design System\n\n## License\n\nApache License 2.0, see [LICENSE](https://github.com/groonga/grafana-datasource-plugin-groonga/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgroonga%2Fgrafana-datasource-plugin-groonga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgroonga%2Fgrafana-datasource-plugin-groonga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgroonga%2Fgrafana-datasource-plugin-groonga/lists"}