设置 InfluxDB

在您开始本教程时，请做以下几点，以确保您所需的一切都已就位。

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

1. 可选： 下载、安装并配置 influx CLI。

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

2. 创建一个全访问API令牌.

   1. 在浏览器中访问 cloud2.influxdata.com 以登录并访问 InfluxDB 用户界面。

   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 命令行界面允许您指定连接配置预设，便于您存储并快速切换多个 InfluxDB 连接凭据。使用 influx config create 命令 创建一个新的 CLI 连接配置。包含以下标志：

   • -n, --config-name: 连接配置名称。这个例子使用 get-started.
   • -u, --host-url: InfluxDB Cloud 无服务器区域 URL.
   • -o, --org: InfluxDB 组织名称.
   • -t, --token: 你的 API token。

   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 无服务器区域 URL.
   • INFLUX_ORG: InfluxDB 组织名称或ID.
   • INFLUX_TOKEN: 你的 API token。

   MacOS 和 Linux PowerShell 命令提示符

   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 云无服务器区域网址.
   • -o, --org: InfluxDB 组织名称或 ID。
   • -t, --token: 你的 API token。

   本快速入门教程中的所有 influx CLI 示例假设您的 InfluxDB 主机、组织 和 令牌 是通过 活动 influx CLI 配置 或环境变量提供的。

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

   MacOS 和 Linux PowerShell 命令提示符

   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 命令提示符

   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 token

   使用API客户端和客户端库时，请记住以下几点：

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

   本快速入门教程中的所有API、cURL和客户端库示例假设您的InfluxDB host、organization、url和token由环境变量提供。

4. 可选： 创建一个桶。

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

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

   InfluxDB 用户界面 influx 命令行工具 InfluxDB API

   1. 在浏览器中访问 cloud2.influxdata.com 登录并访问 InfluxDB 用户界面。

   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

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

   • Headers:
     • 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
         }
       ]
     }'