配置串流

請完成下列步驟，以透過使用者介面來配置串流:

透過使用者介面啟用或停止串流

您可以從 度量資料串流 頁面啟動及停止度量值串流:

1. 以具有管理者權限的使用者身分啟動 Web 使用者介面。 如需如何啟動 Web 使用者介面的相關資訊，請參閱導覽至 Web 使用者介面。

2. 按一下使用者圖示。 這是具有已登入使用者首字母的圖示。 然後按一下 設定。

3. 選取 度量資料串流。 即會顯示串流配置清單。

   

4. 透過切換來啟用或停用串流配置。

列出串流配置

使用此方法，可以取得所有現有串流配置的詳細資料。

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

其中

• <ENDPOINT> 指出 REST API 呼叫所設定的端點目標。 如需相關資訊，請參閱 監視 REST API 端點。 例如，us-south 中可用實例的公用端點如下: https://us-south.monitoring.cloud.ibm.com/api
• 用來向 Monitoring 服務進行鑑別的 <TOKEN> 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>"

其中

• <ENDPOINT> 代表 REST API 呼叫所設定的目標端點。 如需相關資訊，請參閱 監視 REST API 端點。 例如，us-south 中可用實例的公用端點如下: https://us-south.monitoring.cloud.ibm.com/api
• 用來向 Monitoring 服務進行鑑別的 <TOKEN> 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

其中

• <ENDPOINT> 代表 REST API 呼叫所設定的目標端點。 如需相關資訊，請參閱 監視 REST API 端點。 例如，us-south 中可用實例的公用端點如下: https://us-south.monitoring.cloud.ibm.com/api
• 用來向 Monitoring 服務進行鑑別的 <TOKEN> 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\""
        }
    ]
}

更新串流配置

在下列任何 Siuations 中更新串流配置:

• 用來向 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

其中

• <ENDPOINT> 代表 REST API 呼叫所設定的目標端點。 如需相關資訊，請參閱 監視 REST API 端點。 例如，us-south 中可用實例的公用端點如下: https://us-south.monitoring.cloud.ibm.com/api
• 用來向 Monitoring 服務進行鑑別的 <TOKEN> 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"
        }
    ]
}

刪除串流配置

使用此方法來刪除 1 個串流配置，該配置會將一組度量值轉遞至 Event Streams。

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

其中

• <ENDPOINT> 代表 REST API 呼叫所設定的目標端點。 如需相關資訊，請參閱 監視 REST API 端點。 例如，us-south 中可用實例的公用端點如下: https://us-south.monitoring.cloud.ibm.com/api
• 用來向 Monitoring 服務進行鑑別的 <TOKEN> API 記號。 您必須在記號中包含 Bearer。 如需相關資訊，請參閱 使用 Monitoring API 記號。
• <STREAMING_CONFIG_ID> 代表串流配置的 UUID。