适用于 Managed Service for TimescaleDB 的 Aiven 客户端

1. 在 MST Portal中，点击右上角的 User Information。
2. 在 User Profile 页面，导航到 Authentication 选项卡。
3. 点击 Generate Token。
4. 在 Generate access token 对话框中，为令牌输入一个描述性名称。其余字段留空。
5. 复制生成的身份验证令牌并保存。

1. 切换到包含配置文件的安装目录

   cd ~/.config/aiven/

   复制

2. 使用任何编辑器打开 aiven-credentials.json 并使用您的 Managed Service for TimescaleDB User email 和您生成的 authentication token 更新这些行。

   {
     "auth_token": "ABC1+123...TOKEN==",
     "user_email": "your.email@timescale.com"
   }

   复制

3. 保存 aiven-credentials.json 文件。

4. 要验证您是否可以访问 Managed Service for TimescaleDB 上的服务，请键入

   avn project list

   复制

   此命令显示您所有项目的列表。

   PROJECT_NAME       DEFAULT_CLOUD            CREDIT_CARD
    =============     =======================   ===================
    project-xxxx      timescale-aws-us-east-1   xxxx-xxxx-xxxx-xxxx
    project-yyyy      timescale-aws-us-east-1   xxxx-xxxx-xxxx-xxxx
    project-zzzz      timescale-aws-us-east-1   xxxx-xxxx-xxxx-xxxx

   复制

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要分支的服务的项目

   avn project switch <PROJECT>

   复制

3. 列出项目中的服务，并记下输出中 SERVICE_NAME 列下要分支的服务。

   avn service list

   复制

4. 获取要分支的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 创建分支

   avn service create <NAME_OF_FORK> --project <PROJECT_ID>\
   -t <SERVICE_TYPE> --plan <PLAN> --cloud <CLOUD_NAME>\
   -c service_to_fork_from=<NAME_OF_SERVICE_TO_FORK>

   复制

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要集成的 Grafana 服务的项目

   avn switch <PROJECT>

   复制

3. 列出项目中的服务。记下输出中 SERVICE_NAME 列下要集成的 Grafana 服务。

   avn service list

   复制

4. 获取要集成的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 使用您的 Google 开发者控制台中的 <CLIENT_ID> 和 <CLIENT_SECRET> 将插件与您的服务集成

   avn service update -c auth_google.allowed_domains=<G-SUITE_DOMAIN>\
   -c auth_google.client_id=<CLIENT_ID>\
   -c auth_google.client_secret=<CLIENT_SECRET><SERVICE_NAME>

   复制

6. 使用您的服务凭据登录 Grafana。

7. 导航到 Configuration → Plugins 并验证 Google OAuth 应用程序是否被列为插件。

注意

当您使用 -c auth_google.allow_sign_up=true 选项允许注册时，默认情况下，每个新用户都将以 viewer 权限创建，并添加到他们自己新创建的组织中。要指定不同的权限，请使用 -c user_auto_assign_org_role=ROLE_NAME。要将所有新用户添加到主组织，请使用 -c user_auto_assign_org=true 选项。

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要集成的 Grafana 服务的项目

   avn switch <PROJECT>

   复制

3. 列出项目中的服务，并记下输出中 SERVICE_NAME 列下要集成的 Grafana 服务。

   avn service list

   复制

4. 获取要集成的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 使用您的 GitHub OAuth 应用程序中的 <CLIENT_ID> 和 <CLIENT_SECRET> 将插件与您的服务集成

   avn service update -c auth_github.client_id=<CLIENT_ID>\
   -c auth_github.client_secret=<CLIENT_SECRET> <SERVICE_NAME>

   复制

6. 使用您的服务凭据登录 Grafana。

7. 导航到 Configuration → Plugins。插件页面列出了 Grafana 实例的 GitHub OAuth 应用程序。

注意

当您使用 -c auth_github.allow_sign_up=true 选项允许注册时，默认情况下，每个新用户都将以 viewer 权限创建，并添加到他们自己新创建的组织中。要指定不同的权限，请使用 -c user_auto_assign_org_role=ROLE_NAME。要将所有新用户添加到主组织，请使用 -c user_auto_assign_org=true 选项。

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要集成的 Grafana 服务的项目

   avn project switch <PROJECT>

   复制

3. 列出项目中的服务。记下输出中 SERVICE_NAME 列下要集成的 Grafana 服务。

   avn service list

   复制

4. 获取要集成的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 使用您的 GitLab OAuth 应用程序中的 <CLIENT_ID>、<CLIENT_SECRET> 和 <GITLAB_GROUPS> 将插件与您的服务集成

   avn service update -c auth_gitlab.client_id=<CLIENT_ID>\
   -c auth_gitlab.client_secret=<CLIENT_SECRET>\
   -c auth_gitlab.allowed_groups=<GITLAB_GROUPS> <SERVICE_NAME>

   复制

6. 使用您的服务凭据登录 Grafana。

7. 导航到 Configuration → Plugins。插件页面列出了 Grafana 实例的 GitLab OAuth 应用程序。

注意

当您使用 -c auth_gitlab.allow_sign_up=true 选项允许注册时，默认情况下，每个新用户都将以 viewer 权限创建，并添加到他们自己新创建的组织中。要指定不同的权限，请使用 -c user_auto_assign_org_role=ROLE_NAME。要将所有新用户添加到主组织，请使用 -c user_auto_assign_org=true 选项。

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要集成的 Grafana 服务的项目

   avn project switch <PROJECT>

   复制

3. 列出项目中的服务。记下输出中 SERVICE_NAME 列下要配置的 Grafana 服务。

   avn service list

   复制

4. 获取要集成的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 使用 SMTP 值配置 Grafana 服务

   avn service update --project <PROJECT> <SERVICE_NAME>\
      -c smtp_server.host=smtp.example.com \
      -c smtp_server.port=465 \
      -c smtp_server.username=emailsenderuser \
      -c smtp_server.password=emailsenderpass \
      -c smtp_server.from_address="grafana@yourcompany.com"

   复制

6. 可选 查看所有可用自定义选项并配置

   avn service types -v

   复制

您现在可以为 MST 上的 Grafana 服务发送电子邮件。

1. 在 Aiven 客户端中，连接到您的 Managed Service for TimescaleDB 服务。

2. 切换到包含要创建只读副本的 TimescaleDB 服务的项目

   avn project switch <PROJECT>

   复制

3. 列出项目中的服务。记下要为其创建只读副本的服务。您可以在输出的 SERVICE_NAME 列下找到它。

   avn service list

   复制

4. 获取要分支的服务详细信息

   avn service get <SERVICE_NAME>

   复制

5. 创建只读副本

   avn service create <NAME_OF_REPLICA> --project <PROJECT_ID>\
   -t pg --plan <PLAN_TYPE> --cloud timescale-aws-us-east-1\
   -c pg_read_replica=true\
   -c service_to_fork_from=<NAME_OF_SERVICE_TO_FORK>\
   -c pg_version=11 -c variant=timescale

   复制