设置 InfluxDB

在开始本教程之前，请按照以下步骤操作，以确保一切就绪。

• 可选： 下载、安装和配置 influx CLI
• 创建全访问 API 令牌
• 配置认证凭证
• 可选： 创建一个桶

1. 可选： 下载、安装和配置 influx.

   influx CLI 提供了一种简单的方法，可以从命令行与 InfluxDB 交互。有关详细安装和设置说明，请参阅 influx CLI 参考。

2. 创建全访问 API 令牌.

   1. 在浏览器中打开 cloud2.influxdata.com 并登录以访问 InfluxDB UI。

   2. 使用左侧导航栏转到 加载数据 > API 令牌。

      加载数据

   3. 单击 + 生成 API 令牌 并选择 全访问 API 令牌。

   4. 为 API 令牌输入描述并单击 保存。

   5. 复制生成的令牌并妥善保管。

   我们建议使用密码管理器或密钥存储库来安全地存储敏感令牌。

3. 配置认证凭证.

   在本教程中，与 InfluxDB Cloud Serverless 的交互需要您的 InfluxDB URL 或 主机、组织名称或 ID 和您的 API 令牌。根据您用于与 InfluxDB 交互的客户端，提供这些凭证的方法不同。

   在配置令牌时，如果您 创建了全访问令牌，请使用该令牌与 InfluxDB 交互。否则，请使用您的操作员令牌。

   InfluxDB UI influx CLI Telegraf InfluxDB API

   通过 InfluxDB UI 管理 InfluxDB Cloud Serverless 时，会自动使用您登录时关联的凭证提供认证凭证。

   有三种方法向 influx CLI 提供认证凭证

   CLI 连接配置 (推荐)

   influx CLI 允许您指定连接配置预设，以便您可以存储并快速在多组 InfluxDB 连接凭证之间切换。使用 influx config create 命令 创建新的 CLI 连接配置。包括以下标志

   • -n, --config-name：连接配置名称。本示例使用 get-started。
   • -u, --host-url：InfluxDB Cloud Serverless 区域 URL。
   • -o, --org：InfluxDB 组织名称。
   • -t, --token：您的 API 令牌。

   influx config create \
     --config-name 
   get-started
    \
     --host-url https://cloud2.influxdata.com \
     --org 
   ORG_NAME
    \
     --token 
   API_TOKEN
   

   有关 CLI 连接配置的更多信息，请参阅 influx config 命令。

   环境变量

   influx CLI 会检查特定的环境变量，如果存在，则使用这些环境变量来填充身份验证凭据。在您的命令行会话中设置以下环境变量

   • INFLUX_HOST：InfluxDB Cloud Serverless 区域 URL。
   • INFLUX_ORG：InfluxDB 组织名称或 ID。
   • INFLUX_TOKEN：您的 API 令牌。

   MacOS 和 Linux PowerShell CMD

   export INFLUX_HOST=https://cloud2.influxdata.com
   export INFLUX_ORG=
   ORG_NAME
   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_HOST = "https://cloud2.influxdata.com"
   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   $env:INFLUX_ORG = "
   ORG_NAME
   "
   

   set INFLUX_HOST=https://cloud2.influxdata.com
   set INFLUX_ORG=
   ORG_NAME
   set INFLUX_TOKEN=
   API_TOKEN
   # Make sure to include a space character at the end of this command.
   

   命令标志

   使用以下 influx CLI 标志向命令提供所需的凭据

   • --host：InfluxDB Cloud Serverless 区域 URL。
   • -o，--org：InfluxDB 组织名称或 ID。
   • -t，--token：您的 API 令牌。

   本入门教程中所有的 influx CLI 示例都假设您的 InfluxDB 主机、组织 和 令牌 由以下方式提供：激活的 influx CLI 配置 或环境变量。

   本入门教程中 Telegraf 的示例假设您已将 INFLUX_TOKEN 环境变量分配给了您的 InfluxDB 令牌。

   MacOS 和 Linux PowerShell CMD

   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   

   set INFLUX_TOKEN=
   API_TOKEN
    
   # Make sure to include a space character at the end of this command.
   

   替换以下内容

   • API_TOKEN：具有足够权限访问您的桶的 InfluxDB API 令牌。

   本入门教程中的 API（cURL 和客户端库）示例假设您已将环境变量分配给了您的 InfluxDB 凭据。

   要将环境变量分配给您的凭据，请将以下命令输入到您的配置文件设置或终端中

   MacOS 和 Linux PowerShell CMD

   export INFLUX_HOST=https://cloud2.influxdata.com
   export INFLUX_ORG=
   ORG_NAME
   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_HOST = "https://cloud2.influxdata.com"
   $env:INFLUX_ORG = "
   ORG_NAME
   "
   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   

   set INFLUX_HOST=https://cloud2.influxdata.com
   set INFLUX_ORG=
   ORG_NAME
   set INFLUX_TOKEN=
   API_TOKEN
    
   # Make sure to include a space character at the end of this command.
   

   替换以下内容

   • ORG_NAME：您的 InfluxDB 组织名称
   • ORG_ID：您的 InfluxDB 组织 ID
   • API_TOKEN：具有足够权限访问您的桶的 InfluxDB API 令牌。

   在使用 API 客户端和客户端库时请注意以下事项

   • InfluxDB 忽略 API 写入和查询请求中的 org 和 org_id 参数，但一些客户端仍然需要这些参数。
   • 一些客户端使用 host 来指代您的 主机名，您的 InfluxDB Cloud Serverless 区域 URL 无需 https://。

   本入门教程中的所有 API、cURL 和客户端库示例都假设您的 InfluxDB 主机、组织、URL 和 令牌 由环境变量提供。

4. 可选：创建一个桶。

   您可以使用现有的桶或为本次入门教程创建一个新的桶。本教程中的所有示例都假设桶名为 “get-started”。

   使用 InfluxDB UI、influx CLI 或 InfluxDB API 来 创建一个桶。

   InfluxDB UI influx CLI InfluxDB API

   1. 在浏览器中打开 cloud2.influxdata.com 并登录以访问 InfluxDB UI。

   2. 使用左侧导航栏导航到 加载数据 > 桶。

   加载数据

   3. 单击 + 创建桶。

   4. 提供桶名称（get-started）并选择一个 保留期。支持的保留期取决于您的 InfluxDB Cloud Serverless 计划。

   5. 单击 创建。

   1. 如果您还没有，请下载、安装并配置 influx CLI。

   2. 使用influx bucket create 命令创建一个新的存储桶。

      提供以下信息:

      • -n, --name 标志，用于指定存储桶名称。
      • -r, --retention 标志，用于指定存储桶的保留期持续时间。支持的保留期取决于您的 InfluxDB Cloud Serverless 计划。
      • 连接和身份验证凭据

   influx bucket create \
     --name 
   get-started
    \
     --retention 
   7d
   

   要使用 InfluxDB HTTP API 创建存储桶，请通过 POST 请求方法向 InfluxDB API /api/v2/buckets 端点发送请求。

   POST https://cloud2.influxdata.com/api/v2/buckets

   在您的请求中包含以下内容

   • 头部:
     • Authorization: Token INFLUX_TOKEN
     • Content-Type: application/json
   • 请求体: 包含以下属性的 JSON 对象
     • org: InfluxDB 组织名称
     • name: 存储桶名称
     • retentionRules: 定义存储桶保留期的保留规则对象列表。每个保留规则对象具有以下属性
       • type: "expire"
       • everySeconds: 保留期持续时间（秒）。支持的保留期取决于您的 InfluxDB Cloud Serverless 计划。

   curl --request POST \
   "https://cloud2.influxdata.com/api/v2/buckets" \
     --header "Authorization: Token 
   $INFLUX_TOKEN" \
     --header "Content-Type: application/json" \
     --data '{
       "orgID": "'"
   $INFLUX_ORG_ID"'",
       "name": "
   get-started
   ",
       "retentionRules": [
         {
           "type": "expire",
           "everySeconds": 604800
         }
       ]
     }'