스트리밍 구성

UI를 통해 스트리밍을 구성하려면 다음 단계를 완료하십시오.

UI를 통한 스트리밍 사용 또는 중지

메트릭 데이터 스트리밍 페이지에서 메트릭 스트리밍을 시작하고 중지할 수 있습니다.

1. 관리자 권한이 있는 사용자로 웹 UI를 실행하십시오. 웹 UI 실행 방법에 대한 자세한 정보는 웹 UI로 이동을 참조하십시오.

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 엔드포인트 모니터링을 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스에 대한 공용 엔드포인트는 다음과 같습니다. 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 엔드포인트 모니터링을 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스에 대한 공용 엔드포인트는 다음과 같습니다. 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"
        }
    ]
}

스트리밍 구성 작성

메트릭 세트를 Event Streams(으)로 전달하는 1 스트리밍 구성을 구성하려면 이 메소드를 사용하십시오.

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 엔드포인트 모니터링을 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스에 대한 공용 엔드포인트는 다음과 같습니다. 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\""
        }
    ]
}

스트리밍 구성 업데이트

다음과 같은 모든 조치에서 스트리밍 구성을 업데이트하십시오.

• 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 엔드포인트 모니터링을 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스에 대한 공용 엔드포인트는 다음과 같습니다. 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"
        }
    ]
}

스트리밍 구성 삭제

메트릭 세트를 Event Streams(으)로 전달하는 1 스트리밍 구성을 삭제하려면 이 메소드를 사용하십시오.

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 엔드포인트 모니터링을 참조하십시오. 예를 들어, 미국에서 사용 가능한 인스턴스에 대한 공용 엔드포인트는 다음과 같습니다. https://us-south.monitoring.cloud.ibm.com/api
• Monitoring 서비스를 사용하여 인증하는 데 사용하는 <TOKEN> API 토큰입니다. 토큰과 함께 Bearer을(를) 포함해야 합니다. 자세한 정보는 Monitoring API 토큰에 대한 작업의 내용을 참조하십시오.
• <STREAMING_CONFIG_ID>은(는) 스트리밍 구성의 UUID를 나타냅니다.