Configuration de la diffusion en continu

Pour configurer la diffusion en continu via l'interface utilisateur, procédez comme suit :

Activer ou arrêter la diffusion en continu via l'interface utilisateur

Vous pouvez démarrer et arrêter le flux de mesures à partir de la page Flux de données de mesures :

1. Lancez l'interface utilisateur Web en tant qu'utilisateur disposant des droits d'accès administrateur. Pour plus d'informations sur le lancement de l'interface utilisateur Web, voir Accès à l'interface utilisateur Web.

2. Cliquez sur l'icône utilisateur. Elle porte les initiales de l'utilisateur connecté. Cliquez ensuite sur Paramètres.

3. Sélectionnez Flux de données de mesures. La liste des configurations de diffusion en continu s'affiche.

   

4. Activez ou désactivez une configuration de flux à travers la bascule.

Liste des configurations de diffusion en continu

Utilisez cette méthode pour obtenir les détails de toutes les configurations de flot de données existantes.

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

Où

• <ENDPOINT>indique le noeud final ciblé par l'appel API REST. Pour plus d'informations, voir Noeuds finaux d'API REST Monitoring. Par exemple, le noeud final public d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com/api
• Jeton API <TOKEN> que vous utilisez pour vous authentifier auprès du service Monitoring. Vous devez inclure Bearer avec le jeton. Pour plus d'informations, voir Utilisation des jetons d'API Monitoring.

La réponse se présente comme suit :

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

Obtenir les détails d'une configuration de flot de données

Utilisez cette méthode pour obtenir les détails de la configuration 1 de flot de données.

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

Où

• <ENDPOINT> représente le noeud final ciblé par l'appel API REST. Pour plus d'informations, voir Noeuds finaux d'API REST Monitoring. Par exemple, le noeud final public d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com/api
• Jeton API <TOKEN> que vous utilisez pour vous authentifier auprès du service Monitoring. Vous devez inclure Bearer avec le jeton. Pour plus d'informations, voir Utilisation des jetons d'API Monitoring.
• <STREAMING_CONFIG_ID> représente l'UUID de la configuration de flot de données pour laquelle vous souhaitez obtenir des détails.

La réponse se présente comme suit :

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

Création d'une configuration de flot de données

Utilisez cette méthode pour configurer 1 configuration de flot de données qui transmet un ensemble de mesures à Event Streams.

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

Où

• <ENDPOINT> représente le noeud final ciblé par l'appel API REST. Pour plus d'informations, voir Noeuds finaux d'API REST Monitoring. Par exemple, le noeud final public d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com/api
• Jeton API <TOKEN> que vous utilisez pour vous authentifier auprès du service Monitoring. Vous devez inclure Bearer avec le jeton. Pour plus d'informations, voir Utilisation des jetons d'API Monitoring.

Un exemple de fichier streaming-config.json se présente comme suit :

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

Mise à jour d'une configuration de flot de données

Mettez à jour une configuration de flot de données dans l'une des zones suivantes :

• La clé de l'API pour l'authentification auprès de Event Streams est tournée, compromise ou à besoin d’être changée.
• Lorsque vous souhaitez modifier les mesures que vous diffusez, en ajoutant de nouvelles mesures ou en supprimant des mesures.
• Lorsque vous devez modifier la portée.
• Pour activer ou désactiver le flot de données en continu pour la configuration.

Utilisez cette méthode pour mettre à jour 1 configuration de flot de données qui transmet un ensemble de mesures à 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

Où

• <ENDPOINT> représente le noeud final ciblé par l'appel API REST. Pour plus d'informations, voir Noeuds finaux d'API REST Monitoring. Par exemple, le noeud final public d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com/api
• Jeton API <TOKEN> que vous utilisez pour vous authentifier auprès du service Monitoring. Vous devez inclure Bearer avec le jeton. Pour plus d'informations, voir Utilisation des jetons d'API Monitoring.
• <STREAMING_CONFIG_ID> représente l'UUID de la configuration de flot de données.

Un exemple de fichier streaming-config.json se présente comme suit :

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

Supprimer une configuration de flot de données

Utilisez cette méthode pour supprimer 1 configuration de flot de données qui transmet un ensemble de mesures à Event Streams.

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

Où

• <ENDPOINT> représente le noeud final ciblé par l'appel API REST. Pour plus d'informations, voir Noeuds finaux d'API REST Monitoring. Par exemple, le noeud final public d'une instance disponible dans la région us-south est le suivant : https://us-south.monitoring.cloud.ibm.com/api
• Jeton API <TOKEN> que vous utilisez pour vous authentifier auprès du service Monitoring. Vous devez inclure Bearer avec le jeton. Pour plus d'informations, voir Utilisation des jetons d'API Monitoring.
• <STREAMING_CONFIG_ID> représente l'UUID de la configuration de flot de données.