Configura streaming

Completa la seguente procedura per configurare lo streaming tramite l'IU:

Abilita o arresta lo streaming tramite l'interfaccia utente

È possibile avviare e arrestare il flusso di metriche dalla pagina Metric Data Streaming:

1. Avviare l'IU Web come utente con autorità di amministratore. Per ulteriori informazioni su come avviare ilWeb UI, Vedere Navigando versoWeb UI.

2. Fare clic sull'icona dell'utente. Questa è l'icona con le iniziali dell'utente collegato. Quindi, fare clic su Impostazioni.

3. Selezionare Metric Data Streaming. Viene visualizzato l'elenco di configurazioni di flusso.

   

4. Abilitare o disabilitare una configurazione di streaming tramite l'attivazione / disattivazione.

Elencare le configurazioni di streaming

Utilizzare questo metodo per ottenere i dettagli per tutte le configurazioni di streaming esistenti.

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

Dove

• <ENDPOINT> indica l'endpoint di destinazione della chiamata API REST. Per ulteriori informazioni, vedi Monitoraggio degli endpoint API REST. Ad esempio, l'endpoint pubblico per un'istanza disponibile in us - south è il seguente: https://us-south.monitoring.cloud.ibm.com/api
• Token API <TOKEN> che utilizzi per autenticarti con il servizio Monitoring. È necessario includere Bearer con il token. Per ulteriori informazioni, vedi Utilizzo dei token API Monitoring.

La risposta sarà simile alla seguente:

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

Ottieni dettagli per una configurazione di streaming

Utilizzare questo metodo per ottenere i dettagli per 1 configurazione di streaming.

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

Dove

• <ENDPOINT> rappresenta l'endpoint di destinazione della chiamata API REST. Per ulteriori informazioni, vedi Monitoraggio degli endpoint API REST. Ad esempio, l'endpoint pubblico per un'istanza disponibile in us - south è il seguente: https://us-south.monitoring.cloud.ibm.com/api
• Token API <TOKEN> che utilizzi per autenticarti con il servizio Monitoring. È necessario includere Bearer con il token. Per ulteriori informazioni, vedi Utilizzo dei token API Monitoring.
• <STREAMING_CONFIG_ID> rappresenta l'UUID della configurazione del flusso per cui si desidera ottenere i dettagli.

La risposta sarà simile alla seguente:

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

Crea una configurazione di streaming

Utilizza questo metodo per configurare 1 configurazione di flusso che inoltra una serie di metriche a Event Streams.

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

Dove

• <ENDPOINT> rappresenta l'endpoint di destinazione della chiamata API REST. Per ulteriori informazioni, vedi Monitoraggio degli endpoint API REST. Ad esempio, l'endpoint pubblico per un'istanza disponibile in us - south è il seguente: https://us-south.monitoring.cloud.ibm.com/api
• Token API <TOKEN> che utilizzi per autenticarti con il servizio Monitoring. È necessario includere Bearer con il token. Per ulteriori informazioni, vedi Utilizzo dei token API Monitoring.

Un file streaming-config.json di esempio è simile al seguente:

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

Aggiorna una configurazione di streaming

Aggiornare una configurazione di streaming in una delle seguenti siuazioni:

• La chiave API per l'autenticazione con Event Streams è ruotata, compromette o deve essere modificata.
• Quando si desidera modificare le metriche di cui si esegue lo stream, aggiungendo nuove metriche o rimuovendo le metriche.
• Quando è necessario modificare l'ambito.
• Per abilitare o disabilitare il flusso di dati per la configurazione.

Utilizza questo metodo per aggiornare 1 configurazione di streaming che inoltra una serie di metriche a 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

Dove

• <ENDPOINT> rappresenta l'endpoint di destinazione della chiamata API REST. Per ulteriori informazioni, vedi Monitoraggio degli endpoint API REST. Ad esempio, l'endpoint pubblico per un'istanza disponibile in us - south è il seguente: https://us-south.monitoring.cloud.ibm.com/api
• Token API <TOKEN> che utilizzi per autenticarti con il servizio Monitoring. È necessario includere Bearer con il token. Per ulteriori informazioni, vedi Utilizzo dei token API Monitoring.
• <STREAMING_CONFIG_ID> rappresenta l'UUID della configurazione del flusso.

Un file streaming-config.json di esempio è simile al seguente:

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

Elimina una configurazione di streaming

Utilizza questo metodo per eliminare 1 configurazione di streaming che inoltra una serie di metriche a Event Streams.

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

Dove

• <ENDPOINT> rappresenta l'endpoint di destinazione della chiamata API REST. Per ulteriori informazioni, vedi Monitoraggio degli endpoint API REST. Ad esempio, l'endpoint pubblico per un'istanza disponibile in us - south è il seguente: https://us-south.monitoring.cloud.ibm.com/api
• Token API <TOKEN> che utilizzi per autenticarti con il servizio Monitoring. È necessario includere Bearer con il token. Per ulteriori informazioni, vedi Utilizzo dei token API Monitoring.
• <STREAMING_CONFIG_ID> rappresenta l'UUID della configurazione del flusso.