Skip to content

Commit ff6e7d3

Browse files
committed
docs: README
1 parent f760593 commit ff6e7d3

File tree

3 files changed

+32
-50
lines changed

3 files changed

+32
-50
lines changed

README-CN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,8 @@ OpenAPI插件是一个专为Grafana设计的扩展工具,旨在通过可视化
2020
- 数据驱动的洞察:立即深入了解您的云环境,帮助您进行优化和故障排除的明智决策。
2121

2222
## 快速上手
23-
1. 配置:在数据源管理面板, 添加 Pop数据源,在 settings 面板, 设置调用API的阿里云账号的AccessId 和 AccessKeySecret , 最好配置为子账号的AK,调用可能对账号发起线上资源操作,请小心操作,并确保账号具有对应操作的权限。为保证数据安全 , AK保存后清空 , 且不会回显。数据源中提供一些默认产品及参数配置,如果要使用未提供默认配置的产品,请参考对应产品的OpenAPI文档https://next.api.aliyun.com/document
24-
2. 创建仪表板:通过添加 POP 插件面板并配置产品Product、API名称action、及查询参数,即可开始构建您的仪表板。
23+
1. 配置:在数据源管理面板, 添加OpenAPI数据源,在 settings 面板, 设置调用API的阿里云账号的AccessId 和 AccessKeySecret , 最好配置为子账号的AK,调用可能对账号发起线上资源操作,请小心操作,并确保账号具有对应操作的权限。为保证数据安全 , AK保存后清空 , 且不会回显。数据源中提供一些默认产品及参数配置,如果要使用未提供默认配置的产品,请参考对应产品的OpenAPI文档https://next.api.aliyun.com/document
24+
2. 创建仪表板:通过添加OpenAPI插件面板并配置产品Product、API名称action、及查询参数,即可开始构建您的仪表板。
2525
3. 数据可视化:自定义插件解析和显示数据的方式,确保始终能够快速获取相关信息。
2626

2727
## 支持

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ The OpenAPI plugin is an extension tool designed specifically for Grafana, aimed
1717
- Data driven insights: Gain an immediate understanding of your cloud environment, helping you make wise decisions for optimization and troubleshooting.
1818

1919
## Getting Started
20-
1. Configuration: In the data source management panel, add a Pop data source. In the settings panel, set the Access Id and Access KeySecret of the Alibaba Cloud account that calls the API. It is best to configure it as the AK of the sub account. Calling may initiate online resource operations on the account. Please be careful and ensure that the account has the corresponding operation permissions. To ensure data security, AK is cleared after saving and will not echo. The data source provides some default products and parameter configurations. If you want to use products that do not provide default configurations, please refer to the corresponding product's OpenAPI documentation https://next.api.aliyun.com/document
21-
2. Create a dashboard: You can start building your dashboard by adding a POP plugin panel and configuring the product, API name, action, and query parameters.
20+
1. Configuration: In the data source management panel, add an OpenAPI data source. In the settings panel, set the Access Id and Access KeySecret of the Alibaba Cloud account that calls the API. It is best to configure it as the AK of the sub account. Calling may initiate online resource operations on the account. Please be careful and ensure that the account has the corresponding operation permissions. To ensure data security, AK is cleared after saving and will not echo. The data source provides some default products and parameter configurations. If you want to use products that do not provide default configurations, please refer to the corresponding product's OpenAPI documentation https://next.api.aliyun.com/document
21+
2. Create a dashboard: You can start building your dashboard by adding an OpenAPI plugin panel and configuring the product, API name, action, and query parameters.
2222
3. Data visualization: Customize the way plugins parse and display data, ensuring that relevant information can always be quickly obtained.
2323

2424
## Support

src/README.md

Lines changed: 28 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,8 @@
1-
<!-- This README file is going to be the one displayed on the Grafana.com website for your plugin. Uncomment and replace the content here before publishing.
2-
3-
Remove any remaining comments before publishing as these may be displayed on Grafana.com -->
4-
# POP
5-
POP插件是一个专为Grafana设计的扩展工具,旨在通过可视化来自阿里云 OpenAPI 返回的 JSON 数据来增强 Grafana 仪表板的体验。它与 Grafana 无缝集成,允许您直接从 Grafana 仪表板进行阿里云服务的 API 调用,并可视化 JSON 响应。
1+
# OpenAPI
2+
OpenAPI插件是一个专为Grafana设计的扩展工具,旨在通过可视化来自阿里云 OpenAPI 返回的 JSON 数据来增强 Grafana 仪表板的体验。它与 Grafana 无缝集成,允许您直接从 Grafana 仪表板进行阿里云服务的 API 调用,并可视化 JSON 响应。
63

74
## 使用要求
8-
- Aliyun Grafana 实例(版本 9.0.x 或更高
5+
- Grafana 版本 9.0.x 或更高。
96
- 具有适用权限设置的 API 访问阿里云账号和密钥。
107

118
## 特点
@@ -16,55 +13,40 @@ POP插件是一个专为Grafana设计的扩展工具,旨在通过可视化来
1613
- 数据驱动的洞察:立即深入了解您的云环境,帮助您进行优化和故障排除的明智决策。
1714

1815
## 快速上手
19-
1. 配置:在数据源管理面板, 添加 Pop数据源,在 settings 面板, 设置调用API的阿里云账号的AccessId 和 AccessKeySecret , 最好配置为子账号的AK,调用可能对账号发起线上资源操作,请小心操作,并确保账号具有对应操作的权限。为保证数据安全 , AK保存后清空 , 且不会回显。数据源中提供一些默认产品及参数配置,如果要使用未提供默认配置的产品,请参考对应产品的OpenAPI文档https://next.api.aliyun.com/document
20-
2. 创建仪表板:通过添加 POP 插件面板并配置产品Product、API名称action、及查询参数,即可开始构建您的仪表板。
16+
1. 配置:在数据源管理面板, 添加 OpenAPI数据源,在 settings 面板, 设置调用API的阿里云账号的AccessId 和 AccessKeySecret , 最好配置为子账号的AK,调用可能对账号发起线上资源操作,请小心操作,并确保账号具有对应操作的权限。为保证数据安全 , AK保存后清空 , 且不会回显。数据源中提供一些默认产品及参数配置,如果要使用未提供默认配置的产品,请参考对应产品的OpenAPI文档https://next.api.aliyun.com/document
17+
2. 创建仪表板:通过添加OpenAPI插件面板并配置产品Product、API名称action、及查询参数,即可开始构建您的仪表板。
2118
3. 数据可视化:自定义插件解析和显示数据的方式,确保始终能够快速获取相关信息。
2219

2320
## 支持
2421
如果您遇到任何问题或需要帮助,请加入钉钉群34785590。
25-
<img src="img/ding.png" alt="" title="Example Image Title" width="300" height="300" />
26-
27-
28-
<!-- To help maximize the impact of your README and improve usability for users, we propose the following loose structure:
29-
30-
**BEFORE YOU BEGIN**
31-
- Ensure all links are absolute URLs so that they will work when the README is displayed within Grafana and Grafana.com
32-
- Be inspired ✨
33-
- [grafana-polystat-panel](https://github.com/grafana/grafana-polystat-panel)
34-
- [volkovlabs-variable-panel](https://github.com/volkovlabs/volkovlabs-variable-panel)
35-
36-
**ADD SOME BADGES**
37-
38-
Badges convey useful information at a glance for users whether in the Catalog or viewing the source code. You can use the generator on [Shields.io](https://shields.io/badges/dynamic-json-badge) together with the Grafana.com API
39-
to create dynamic badges that update automatically when you publish a new version to the marketplace.
4022

41-
- For the logo field use 'grafana'.
42-
- Examples (label: query)
43-
- Downloads: $.downloads
44-
- Catalog Version: $.version
45-
- Grafana Dependency: $.grafanaDependency
46-
- Signature Type: $.versionSignatureType
23+
---
4724

48-
Full example: ![Dynamic JSON Badge](https://img.shields.io/badge/dynamic/json?logo=grafana&query=$.version&url=https://grafana.com/api/plugins/grafana-polystat-panel&label=Marketplace&prefix=v&color=F47A20)
49-
50-
Consider other [badges](https://shields.io/badges) as you feel appropriate for your project.
51-
52-
## Overview / Introduction
53-
Provide one or more paragraphs as an introduction to your plugin to help users understand why they should use it.
54-
55-
Consider including screenshots:
56-
- in [plugin.json](https://grafana.com/developers/plugin-tools/reference-plugin-json#info) include them as relative links.
57-
- in the README ensure they are absolute URLs.
25+
# OpenAPI
26+
The OpenAPI plugin is an extension tool designed specifically for Grafana, aimed at enhancing the experience of the Grafana dashboard by visualizing JSON data returned from Alibaba Cloud OpenAPI. It seamlessly integrates with Grafana, allowing you to make API calls to Alibaba Cloud services directly from the Grafana dashboard and visualize JSON responses.
5827

5928
## Requirements
60-
List any requirements or dependencies they may need to run the plugin.
29+
- Grafana version 9.0. x or higher.
30+
- Access Alibaba Cloud accounts and keys through APIs with applicable permission settings.
31+
32+
## Featues
33+
- Easy integration: Easily integrate within your existing Grafana instance with minimal configuration.
34+
- Real time visualization: Convert JSON responses from Alibaba Cloud OpenAPI into interactive charts and graphics in real time.
35+
- Customizable dashboard: Effectively create customized visual representations to monitor and analyze your Alibaba Cloud resources.
36+
- User friendly interface: Easy navigation and plugin configuration, bringing powerful analysis functions to users.
37+
- Data driven insights: Gain an immediate understanding of your cloud environment, helping you make wise decisions for optimization and troubleshooting.
6138

6239
## Getting Started
63-
Provide a quick start on how to configure and use the plugin.
40+
1. Configuration: In the data source management panel, add an OpenAPI data source. In the settings panel, set the Access Id and Access KeySecret of the Alibaba Cloud account that calls the API. It is best to configure it as the AK of the sub account. Calling may initiate online resource operations on the account. Please be careful and ensure that the account has the corresponding operation permissions. To ensure data security, AK is cleared after saving and will not echo. The data source provides some default products and parameter configurations. If you want to use products that do not provide default configurations, please refer to the corresponding product's OpenAPI documentation https://next.api.aliyun.com/document
41+
2. Create a dashboard: You can start building your dashboard by adding an OpenAPI plugin panel and configuring the product, API name, action, and query parameters.
42+
3. Data visualization: Customize the way plugins parse and display data, ensuring that relevant information can always be quickly obtained.
43+
44+
## Support
45+
If you encounter any problems or need help, please join the DingTalk group 34785590.
6446

65-
## Documentation
66-
If your project has dedicated documentation available for users, provide links here. For help in following Grafana's style recommendations for technical documentation, refer to our [Writer's Toolkit](https://grafana.com/docs/writers-toolkit/).
47+
## License
48+
[Apache-2.0](http://www.apache.org/licenses/LICENSE-2.0)
49+
aliyun-openapi-grafana-datasource-plugin is a grafana plugin developed by Alibaba and licensed under the Apache License (Version 2.0)
50+
This product contains various third-party components under other open source licenses.
51+
See the NOTICE file for more information.
6752

68-
## Contributing
69-
Do you want folks to contribute to the plugin or provide feedback through specific means? If so, tell them how!
70-
-->

0 commit comments

Comments
 (0)