Configurar fluxo

Conclua as etapas a seguir para configurar o fluxo por meio da IU:

Ative ou interrompa o fluxo por meio da IU

É possível iniciar e parar o fluxo de métricas na página Fluxo de dados de métrica:

1. Ative a IU da web como um usuário com autoridade de administrador. Para obter mais informações sobre como ativar a IU da web, consulte Navegando para a IU da web.

2. Clique no ícone Usuário. Este é o ícone com as iniciais do usuário conectado. Em seguida, clique em Configurações.

3. Selecione Fluxo de dados de métrica. A lista de configurações de fluxo é exibida.

   

4. Ative ou desative uma configuração de fluxo por meio de alternância.

Listar as configurações de fluxo

Use este método para obter os detalhes para todas as configurações de fluxo existentes.

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

em que

• <ENDPOINT>indica o terminal de destino pela chamada de API de REST. Para obter mais informações, consulte Monitorando terminais da API de REST. Por exemplo, o terminal público para uma instância que está disponível em us-south é o seguinte: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> Token de API que você usa para autenticar com o serviço Monitoring. Deve-se incluir Bearer com o token. Para obter mais informações, consulte Trabalhando com tokens de API do Monitoring.

A resposta será semelhante à seguinte:

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

Obter detalhes para uma configuração de fluxo

Use este método para obter os detalhes para uma configuração de fluxo.

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

em que

• <ENDPOINT> representa o terminal que é destinado pela chamada da API de REST. Para obter mais informações, consulte Monitorando terminais da API de REST. Por exemplo, o terminal público para uma instância que está disponível em us-south é o seguinte: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> Token de API que você usa para autenticar com o serviço Monitoring. Deve-se incluir Bearer com o token. Para obter mais informações, consulte Trabalhando com tokens de API do Monitoring.
• <STREAMING_CONFIG_ID> representa o UUID da configuração de fluxo para a qual você deseja obter detalhes.

A resposta será semelhante à seguinte:

{
    "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"
        }
    ]
}

Criar uma configuração de fluxo

Use este método para definir uma configuração de fluxo que encaminha um conjunto de métricas para Event Streams.

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

em que

• <ENDPOINT> representa o terminal que é destinado pela chamada da API de REST. Para obter mais informações, consulte Monitorando terminais da API de REST. Por exemplo, o terminal público para uma instância que está disponível em us-south é o seguinte: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> Token de API que você usa para autenticar com o serviço Monitoring. Deve-se incluir Bearer com o token. Para obter mais informações, consulte Trabalhando com tokens de API do Monitoring.

Um arquivo de amostra streaming-config.json se parece com o seguinte:

{
    "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\""
        }
    ]
}

Atualizar uma configuração de fluxo

Atualize uma configuração de fluxo em qualquer uma das situações a seguir:

• A chave de API para autenticar com Event Streams foi girada, comprometida ou precisa de alteração.
• Quando você deseja mudar as métricas do fluxo por meio da inclusão de novas métricas ou da remoção de métricas.
• Quando você deve mudar o escopo.
• Para ativar ou desativar o fluxo de dados para a configuração.

Use este método para atualizar uma configuração de fluxo que encaminha um conjunto de métricas para 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

em que

• <ENDPOINT> representa o terminal que é destinado pela chamada da API de REST. Para obter mais informações, consulte Monitorando terminais da API de REST. Por exemplo, o terminal público para uma instância que está disponível em us-south é o seguinte: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> Token de API que você usa para autenticar com o serviço Monitoring. Deve-se incluir Bearer com o token. Para obter mais informações, consulte Trabalhando com tokens de API do Monitoring.
• <STREAMING_CONFIG_ID> representa o UUID da configuração de fluxo.

Um arquivo de amostra streaming-config.json se parece com o seguinte:

{
    "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"
        }
    ]
}

Excluir uma configuração de fluxo

Use este método para excluir uma configuração de fluxo que encaminha um conjunto de métricas para Event Streams.

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

em que

• <ENDPOINT> representa o terminal que é destinado pela chamada da API de REST. Para obter mais informações, consulte Monitorando terminais da API de REST. Por exemplo, o terminal público para uma instância que está disponível em us-south é o seguinte: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> Token de API que você usa para autenticar com o serviço Monitoring. Deve-se incluir Bearer com o token. Para obter mais informações, consulte Trabalhando com tokens de API do Monitoring.
• <STREAMING_CONFIG_ID> representa o UUID da configuração de fluxo.