{"id":19411473,"url":"https://github.com/volcengine/tls-grafana-datasource","last_synced_at":"2026-02-05T07:31:53.646Z","repository":{"id":181790971,"uuid":"667304043","full_name":"volcengine/tls-grafana-datasource","owner":"volcengine","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-11T03:54:26.000Z","size":133108,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-24T10:44:13.511Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/volcengine.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,"zenodo":null}},"created_at":"2023-07-17T07:51:48.000Z","updated_at":"2024-11-12T04:08:31.000Z","dependencies_parsed_at":"2024-12-11T04:36:11.430Z","dependency_job_id":null,"html_url":"https://github.com/volcengine/tls-grafana-datasource","commit_stats":null,"previous_names":["volcengine/tls-grafana-datasource"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/volcengine/tls-grafana-datasource","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Ftls-grafana-datasource","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Ftls-grafana-datasource/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Ftls-grafana-datasource/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Ftls-grafana-datasource/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/volcengine","download_url":"https://codeload.github.com/volcengine/tls-grafana-datasource/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/volcengine%2Ftls-grafana-datasource/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29115533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T05:31:32.482Z","status":"ssl_error","status_checked_at":"2026-02-05T05:31:29.075Z","response_time":65,"last_error":"SSL_read: 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":"2024-11-10T12:21:35.051Z","updated_at":"2026-02-05T07:31:53.628Z","avatar_url":"https://github.com/volcengine.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## 火山引擎日志服务数据源\n## 安装\n\n依赖 Grafana \u003e= [9.x版本](https://codeload.github.com/volcengine/tls-grafana-datasource/zip/refs/heads/main) \u003c/br\u003e \nGrafana 6.x~8.x版本请使用[1.0版本](https://codeload.github.com/volcengine/tls-grafana-datasource/zip/refs/tags/v1.2)\n1. 克隆本项目或者下载代码压缩包到grafana插件目录下 , 然后重启grafana\n\n* 使用RPM或者YUM安装的Grafana  \n插件目录是 /usr/lib/grafana/plugins：\n```\nunzip tls-grafana-datasource-main.zip -d /var/lib/grafana/plugins\n```\n* 使用.tar.gz文件安装的Grafana  \n插件目录是 {PATH_TO}/grafana-6.6.0/data/plugins：\n```\nunzip tls-grafana-datasource-main.zip -d {PATH_TO}/grafana-6.6.0/data/plugins\n```\n2. Grafana\u003e=7.x(6.x及以下版本不需要)配置权限，允许加载未签名的Grafana插件。\n* 使用RPM或者YUM安装的Grafana  \n配置文件路径为:/etc/grafana/grafana.ini\n* 使用.tar.gz文件安装的Grafana  \n配置文件路径为:{PATH_TO}/grafana-6.6.0/conf/defaults.ini\n\n设置\n```\nallow_loading_unsigned_plugins = tls-grafana-datasource\n```\n3. 重启Grafana。  \n首先，kill终止Grafana进程。然后执行重启命令\n* 使用RPM或者YUM安装的Grafana:\n```\nsystemctl restart grafana-server\n```\n* 使用.tar.gz文件安装的Grafana:\n```\n./bin/grafana-server\n```\n## 使用\n目前TLS的Grafana插件支持时间序列图、表格两种形式的图表。\n1. 时间序列图既是随着时间变化的折线图。\n2. 表格是明细日志的查看。\n### 添加数据源\n\n1. 在数据源管理面板, 添加 LogService 数据源\n\n2. 在 settings 面板, 设置 URL 为您日志服务endpoint,例如： https://tls-cn-beijing.volces.com\n，Access 设置为 Server(Default)\n\n3. 设置 Region、Topic参数,以及账号的AccessKeyId\n,设置 AccessKeyId 和 AccessKeySecret。\u003cbr\u003e\n注：Grafana版本在\u003e=9.x版本，数据源创建支持AccountMode选项，只填写AccessKeyId、AccessKeySecret，在数据查询时选择region和topic。\n\n4. 设置完成后，点击保存可以测试数据源是否可以访问。\n![配置数据源](./src/img/config_datasource.png)\n\n## 添加图表\n### 时间序列图表(TimeSeries)\n配置参数\n```\n图表类型: Time\nxcol: time\nycol: PV, UV\nquery: * | select (__time__ - (__time__ % 60000)) as time,count(1) as PV, count(distinct account_id) as UV group by time\n```\n![stat图](./src/img/time.png)\n动态指标：如果想把一个维度爆炸为指标，配置为x轴配置time,dimension，y轴配置为PV，UV，就可以把PV、UV指标增加为dimension_1_value*PV,dimension_1_value*UV...dimension_n_value*PV,dimension_n_value*UV，共2n个指标。目前折线数量限制2n\u003c=100。\n```\n图表类型: Time\nxcol: time,dimension\nycol: PV, UV\nquery: * | select (__time__ - (__time__ % 60000)) as time,dimension,count(1) as PV, count(distinct account_id) as UV group by time,dimension\n```\n### 单值图(Stat / Gauge)\n配置参数\n```\n图表类型: Stat\nxcol: stat\nycol: PV, UV\nquery: * | select count(1) as PV, count(distinct account_id) as UV\n```\n![stat图](./src/img/stat.png)\n\n### 饼图(Pie)\n配置参数\n```\n图表类型: Pie\nxcol: Pie\nycol: status,cnt\nquery: status\u003e200 | select status,count(*) cnt group by status\n```\n![stat图](./src/img/pie.png)\n\n### 柱状图(Pie)\n配置参数\n```\n图表类型: Bar\nxcol: bar\nycol: method,PV,UV\nquery: * | select method,count(1) as PV,count(distinct account_id) as UV group by method\n```\n![柱状图](./src/img/bar.png)\n### 表格\n配置参数\n```\n图表类型: Table\nxcol: table\nycol: time,PV,UV\nquery: * | select (__time__ - (__time__ % 60000)) as time,count(1) as PV, count(distinct account_id) as UV group by time\n```\n![表格](./src/img/table.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Ftls-grafana-datasource","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvolcengine%2Ftls-grafana-datasource","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvolcengine%2Ftls-grafana-datasource/lists"}