配置流式方法

完成以下步骤以通过 UI 配置流式方法:

通过 UI 启用或停止流式方法

您可以从“度量数据流”页面启动和停止度量流:

1. 以具有管理员权限的用户身份启动 Web UI。 有关如何启动 Web UI 的更多信息，请参阅导航至 Web UI。

2. 单击 用户图标。 这是具有已登录用户的首字母的图标。 然后单击 设置。

3. 选择 度量数据流。 这将显示流式配置的列表。

   

4. 通过切换启用或禁用流式配置。

列出流式配置

使用此方法可获取所有现有流式配置的详细信息。

curl --request GET https://<ENDPOINT>/api/v1/dataStream/configs
 -H "content-type: application/json"
 -H "Authorization: <TOKEN>"

Where

• <ENDPOINT> 指示 REST API 调用所指向的端点。 有关更多信息，请参阅 监视 REST API 端点。 例如，在 us-south 中可用的实例的公共端点如下所示: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> 用于向 Monitoring 服务认证的 API 令牌。 必须在令牌中包含 Bearer。 有关更多信息，请参阅 使用 Monitoring API 令牌。

回答可能类似于以下内容：

{"dataStreamConfigs":[{"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","enabled":true,"name":"Streaming metrics - demo","type":"kafka"}]}

获取流式配置的详细信息

使用此方法可获取 1 流式配置的详细信息。

curl --request GET https://<ENDPOINT>/api/v1/dataStream/configs/<STREAMING_CONFIG_ID>
 -H "content-type: application/json"
 -H "Authorization: <TOKEN>"

Where

• <ENDPOINT> 表示 REST API 调用的目标端点。 有关更多信息，请参阅 监视 REST API 端点。 例如，在 us-south 中可用的实例的公共端点如下所示: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> 用于向 Monitoring 服务认证的 API 令牌。 必须在令牌中包含 Bearer。 有关更多信息，请参阅 使用 Monitoring API 令牌。
• <STREAMING_CONFIG_ID> 表示要获取其详细信息的流式配置的 UUID。

回答可能类似于以下内容：

{
    "dataStreamConfig": {
        "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "enabled": true,
        "name": "Streaming metrics - demo",
        "emitterType": "kafka",
        "emitterProperties": {
            "bootstrap.servers": "kafka-0.mh-svc1.eu-de.containers.appdomain.cloud:9093, kafka-2.mh-svc2-0000.eu-de.containers.appdomain.cloud:9093,kafka-1.mh-svc3.eu-de.containers.appdomain.cloud:9093",
            "topic.name": "my-monitoring-topic",
            "compression.type": "lz4",
            "security.protocol": "SASL_SSL",
            "sasl.mechanism": "PLAIN",
            "sasl.jaas.config": "org.apache.kafka.common.security.plain.PlainLoginModule required username=\"token\" password=\"xxxxxxxxxxxxx\";","ssl.truststore.base64.content":""}},"dataStreamRules":[{"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","enabled":true,"metrics":["kube_daemonset_labels","kube_node_status_condition"],"aggregation":"avg","aggregationSec":10,"scope":"kubernetes.cluster.name = \"mycluster\"",
            "dataStreamConfigUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        }
    ]
}

创建流式配置

使用此方法来配置 1 流式配置，以将一组度量转发到 Event Streams。

curl --request POST https://<ENDPOINT>/api/v1/dataStream/configs
 -H "content-type: application/json"
 -H "Authorization: <TOKEN>"
 -d @streaming-config.json

Where

• <ENDPOINT> 表示 REST API 调用的目标端点。 有关更多信息，请参阅 监视 REST API 端点。 例如，在 us-south 中可用的实例的公共端点如下所示: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> 用于向 Monitoring 服务认证的 API 令牌。 必须在令牌中包含 Bearer。 有关更多信息，请参阅 使用 Monitoring API 令牌。

样本 streaming-config.json 文件如下所示:

{
    "dataStreamConfig": {
        "enabled": true,
        "name": "Streaming metrics config",
        "emitterType": "kafka",
        "emitterProperties": {
            "bootstrap.servers": "kafka-0.mh-svc1.eu-de.containers.appdomain.cloud:9093,kafka-2.mh-svc2.eu-de.containers.appdomain.cloud:9093,kafka-1.mh-svc3.eu-de.containers.appdomain.cloud:9093",
            "topic.name": "my-monitoring-topic",
            "compression.type": "lz4",
            "security.protocol": "SASL_SSL",
            "sasl.mechanism": "PLAIN",
            "sasl.jaas.config": "org.apache.kafka.common.security.plain.PlainLoginModule required username=\"token\" password=\"xxxxxxxxxx\";",
            "ssl.truststore.base64.content": ""
        }
    },
    "dataStreamRules": [
        {
            "enabled": true,
            "metrics": [
                "kube_daemonset_labels",
                "kube_node_status_condition"
            ],
            "aggregation": "avg",
            "aggregationSec": 10,
            "scope": "kubernetes.cluster.name = \"mycluster\""
        }
    ]
}

更新流式配置

在以下任何筛选中更新流式配置:

• 用于向 Event Streams 认证的 API 密钥已轮换，已处理或需要更改。
• 当您要通过添加新度量或除去度量来更改流中的度量时。
• 必须更改作用域时。
• 对配置启用或禁用数据流式传输。

使用此方法来更新 1 流式配置，该配置将一组度量值转发到 Event Streams。

curl --request PUT https://<ENDPOINT>/api/v1/dataStream/configs/<STREAMING_CONFIG_ID>
 -H "content-type: application/json"
 -H "Authorization: <TOKEN>"
 -d @streaming-config.json

Where

• <ENDPOINT> 表示 REST API 调用的目标端点。 有关更多信息，请参阅 监视 REST API 端点。 例如，在 us-south 中可用的实例的公共端点如下所示: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> 用于向 Monitoring 服务认证的 API 令牌。 必须在令牌中包含 Bearer。 有关更多信息，请参阅 使用 Monitoring API 令牌。
• <STREAMING_CONFIG_ID> 表示流式配置的 UUID。

样本 streaming-config.json 文件如下所示:

{
    "dataStreamConfig": {
        "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "enabled": true,
        "name": "Streaming metrics - demo",
        "emitterType": "kafka",
        "emitterProperties": {
            "bootstrap.servers": "kafka-0.mh-svc1.eu-de.containers.appdomain.cloud:9093, kafka-2.mh-svc2-0000.eu-de.containers.appdomain.cloud:9093,kafka-1.mh-svc3.eu-de.containers.appdomain.cloud:9093",
            "topic.name": "my-monitoring-topic",
            "compression.type": "lz4",
            "security.protocol": "SASL_SSL",
            "sasl.mechanism": "PLAIN",
            "sasl.jaas.config": "org.apache.kafka.common.security.plain.PlainLoginModule required username=\"token\" password=\"xxxxxxxxxxxxx\";","ssl.truststore.base64.content":""}},"dataStreamRules":[{"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","enabled":true,"metrics":["kube_daemonset_labels","kube_node_status_condition"],"aggregation":"avg","aggregationSec":10,"scope":"kubernetes.cluster.name = \"mycluster\"",
            "dataStreamConfigUuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        }
    ]
}

删除流式配置

使用此方法可删除将一组度量值转发到 Event Streams的 1 流式配置。

curl --request DELETE https://<ENDPOINT>/api/v1/dataStream/configs/<STREAMING_CONFIG_ID>
 -H "content-type: application/json"
 -H "Authorization: <TOKEN>"

Where

• <ENDPOINT> 表示 REST API 调用的目标端点。 有关更多信息，请参阅 监视 REST API 端点。 例如，在 us-south 中可用的实例的公共端点如下所示: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> 用于向 Monitoring 服务认证的 API 令牌。 必须在令牌中包含 Bearer。 有关更多信息，请参阅 使用 Monitoring API 令牌。
• <STREAMING_CONFIG_ID> 表示流式配置的 UUID。