{"id":20260142,"url":"https://github.com/influxdata/influxdb-gds-connector","last_synced_at":"2025-07-19T12:34:07.955Z","repository":{"id":38094439,"uuid":"267009331","full_name":"influxdata/influxdb-gds-connector","owner":"influxdata","description":"Google Data Studio Connector for InfluxDB.","archived":false,"fork":false,"pushed_at":"2022-12-08T08:24:33.000Z","size":2356,"stargazers_count":11,"open_issues_count":2,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-11T01:40:44.431Z","etag":null,"topics":["analytics","community-connector","google-data-studio","influxdb"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/influxdata.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}},"created_at":"2020-05-26T10:10:04.000Z","updated_at":"2023-11-07T08:40:08.000Z","dependencies_parsed_at":"2023-01-25T09:15:52.966Z","dependency_job_id":null,"html_url":"https://github.com/influxdata/influxdb-gds-connector","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/influxdata/influxdb-gds-connector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finfluxdb-gds-connector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finfluxdb-gds-connector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finfluxdb-gds-connector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finfluxdb-gds-connector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/influxdata","download_url":"https://codeload.github.com/influxdata/influxdb-gds-connector/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/influxdata%2Finfluxdb-gds-connector/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265934210,"owners_count":23852089,"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":["analytics","community-connector","google-data-studio","influxdb"],"created_at":"2024-11-14T11:18:09.339Z","updated_at":"2025-07-19T12:34:07.903Z","avatar_url":"https://github.com/influxdata.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InfluxDB Connector for Google Data Studio\n\n[![CircleCI](https://circleci.com/gh/influxdata/influxdb-gds-connector.svg?style=svg)](https://circleci.com/gh/influxdata/influxdb-gds-connector)\n[![codecov](https://codecov.io/gh/influxdata/influxdb-gds-connector/branch/master/graph/badge.svg)](https://codecov.io/gh/influxdata/influxdb-gds-connector)\n[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)\n[![License](https://img.shields.io/github/license/influxdata/influxdb-gds-connector.svg)](https://github.com/influxdata/influxdb-gds-connector/blob/master/LICENSE)\n[![GitHub issues](https://img.shields.io/github/issues-raw/influxdata/influxdb-gds-connector.svg)](https://github.com/influxdata/influxdb-gds-connector/issues)\n[![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/influxdata/influxdb-gds-connector.svg)](https://github.com/influxdata/influxdb-gds-connector/pulls)\n[![Slack Status](https://img.shields.io/badge/slack-join_chat-white.svg?logo=slack\u0026style=social)](https://www.influxdata.com/slack)\n\n*This is not an official Google product.*\n\nThis [Data Studio] [Connector] lets users query datasets from [InfluxDB v2] instances through the [InfluxDB API].\n## How it works\n\nConnect your InfluxDB to Google Data Studio and start pushing  your data to in minutes.\n\n### How to add the InfluxDB Connector to Data Studio\n\n#### Direct link\n\nTo add the InfluxDB Connector in Data Studio you can use this link: \n\n[![Use InfluxDB DataSource](docs/button.png)](https://datastudio.google.com/u/0/datasources/create?connectorId=AKfycbwhJChhmMypQvNlihgRJMAhCb8gaM3ii9oUNWlW_Cp2PbJSfqeHfPyjNVp15iy9ltCs). \n\n#### From Data Studio\n\nTBD: If you are already in Data Studio, click the \"Create\" button and select \"Data Source\". From there you can search for the InfluxDB Connector.\n\n\u003cimg src=\"docs/datastudio-connector.png\" height=\"350px\"\u003e\n\n### Connect your InfluxDB to Data Studio\n\nTo access your InfluxDB, enter your Connection information: \n\n- `InfluxDB URL` \n- `Token` \n- `Organization` \n- `Bucket` \n- `Measurement` \n\n\u003cimg src=\"docs/datastudio-connection.jpg\" height=\"350px\"\u003e\n\n- [How to retrieve the Organization](https://v2.docs.influxdata.com/v2.0/organizations/view-orgs/)\n- [How to retrieve the Token](https://v2.docs.influxdata.com/v2.0/security/tokens/view-tokens/)\n\n#### Set up Metrics\n\nOnce you are connected, Data Studio will show you a list of all the fields available from your **Measurement**. \nThis includes your _Tag set_, _Field set_ and _Timestamp_. \n\n\u003cimg src=\"docs/datastudio-fields.png\" height=\"350px\"\u003e\n\n### Visualize your data in Data Studio\n\nAfter you have reviewed the fields, press \"CREATE REPORT\" button to create your report. \n\n\u003cimg src=\"docs/datastudio-report.png\" height=\"350px\"\u003e\n\n## Inspiration\n\n- [COVID-19 report powered by InfluxDB](/examples/)\n\n## InfluxDB 1.8 compatibility\n\n[InfluxDB 1.8.0 introduced forward compatibility APIs](https://docs.influxdata.com/influxdb/v1.8/tools/api/#influxdb-20-api-compatibility-endpoints) for InfluxDB 2.0. This allow you to easily move from InfluxDB 1.x to InfluxDB 2.0 Cloud or open source.\n\nConnector usage differences:\n1. Use the form `username:password` for an **authentication token**. Example: `my-user:my-password`. Use an empty string (`\"\"`) if the server doesn't require authentication.\n1. The organization parameter is not used. Use a string `-` as a value.\n\n## Troubleshooting\n\n### This app isn't verified\n\nWhen authorizing the connector, an OAuth consent screen may be presented to you with a warning \"This app isn't verified\". \nThis is because the connector has requested authorization to make requests to an external API (E.g. to fetch data from the service you're connecting to). \n\n\u003e This warning will no longer be display after the connector will include in Partner connectors gallery - see [#2](https://github.com/influxdata/influxdb-gds-connector/issues/2)\n\n### Data optimize\n\nThe connector uses two types of query: `schema query` and `data query`. \nPlease, check that both of them correctly works with your dataset.\n\n#### Schema query\n\nIt is used to determine all your fields from configured `Bucket` and `Measurement`. The query is used only in the configuration.\n\n```flux\nimport \"influxdata/influxdb/v1\"\n\nbucket = \"my-bucket\"\nmeasurement = \"my-measurement\"\nstart_range = duration(v: uint(v: 1970-01-01) - uint(v: now()))\n\nv1.tagKeys(\n  bucket: bucket,\n  predicate: (r) =\u003e r._measurement == measurement,\n  start: start_range\n) |\u003e filter(fn: (r) =\u003e r._value != \"_start\" and r._value != \"_stop\" and r._value != \"_measurement\" and r._value != \"_field\")\n  |\u003e yield(name: \"tags\")\n\nfrom(bucket: bucket)\n  |\u003e range(start: start_range)\n  |\u003e filter(fn: (r) =\u003e r[\"_measurement\"] == measurement)\n  |\u003e keep(fn: (column) =\u003e column == \"_field\" or column == \"_value\")\n  |\u003e unique(column: \"_field\")\n  |\u003e yield(name: \"fields\")\n```\n\nYou can optimize this query by `Schema Query Range` configuration in first step of Data Studio connection wizard:\n\n\u003cimg src=\"docs/datastudio-schema-query-range.png\" height=\"350px\"\u003e\n\nthen the `start_range` of query will be `-6h`.\n\n#### Data query\n\nIt is used for retrieve data from InfluxDB. \nThe time-range is configured via [Date Range Control Widget](https://support.google.com/datastudio/answer/6291067?hl=en).\n\n```flux\nbucket = \"my-bucket\"\nmeasurement = \"my-measurement\"\n// Configure DataRange in Data Studio - https://support.google.com/datastudio/answer/6291067?hl=en\nstart = time(v: 1) // or start of specified Data Range\nstop = now() // or end of specified Data Range\n\nfrom(bucket: bucket) \n|\u003e range(start: start, stop: stop) \n|\u003e filter(fn: (r) =\u003e r[\"_measurement\"] == measurement) \n|\u003e pivot(rowKey:[\"_time\"], columnKey: [\"_field\"], valueColumn: \"_value\")\n```\n\n[Data Studio]: https://datastudio.google.com\n[Connector]: https://developers.google.com/datastudio/connector\n[InfluxDB v2]: https://www.influxdata.com/products/influxdb-overview/influxdb-2-0/\n[InfluxDB API]: https://v2.docs.influxdata.com/v2.0/reference/api/\n\n## Development\n\n- Test version of the Connector: [AKfycbySDF4eD7wmA_awZ6aoCwENuXs1Opw_T0DIJ8F](https://datastudio.google.com/u/0/datasources/create?connectorId=AKfycbySDF4eD7wmA_awZ6aoCwENuXs1Opw_T0DIJ8F-MVI)\n- Production version of the Connector: [AKfycbwhJChhmMypQvNlihgRJMAhCb8gaM3ii9oUNWlW_Cp2PbJSfqeHfPyjNVp15iy9ltCs](https://datastudio.google.com/u/0/datasources/create?connectorId=AKfycbwhJChhmMypQvNlihgRJMAhCb8gaM3ii9oUNWlW_Cp2PbJSfqeHfPyjNVp15iy9ltCs)\n\nOpen Apps Script project in your browser:\n\n```bash\n$ yarn open\n```\n\nor\n\nhttps://script.google.com/home/projects/18YPFhvO1TMR7QFCw2iFuIH_1_iPvFIYrnT3fg8J7skoqUd5x7YAnPD7_/edit\n\nPush your local changes to Apps Script:\n\n```bash\n$ yarn push\n```\n\nUpdate the production deployment of connector:\n\n```bash\n$ yarn deploy\n```\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/influxdata/influxdb-gds-connector.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfluxdata%2Finfluxdb-gds-connector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finfluxdata%2Finfluxdb-gds-connector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finfluxdata%2Finfluxdb-gds-connector/lists"}