Streaming konfigurieren

Gehen Sie wie folgt vor, um das Streaming über die Benutzerschnittstelle zu konfigurieren:

Streaming über die Benutzerschnittstelle aktivieren oder stoppen

Sie können die Übertragung von Metriken per Streaming über die Seite Streaming von Metrikdaten starten und stoppen:

1. Starten Sie die Webbenutzerschnittstelle als Benutzer mit Administratorberechtigung. Weitere Informationen zum Starten der Webbenutzerschnittstelle finden Sie im Abschnitt Zur Webbenutzerschnittstelle navigieren.

2. Klicken Sie auf das Bearbeitungssymbol. Dies ist das Symbol mit den Initialen des angemeldeten Benutzers. Klicken Sie anschließend auf Einstellungen.

3. Wählen Sie Metrikdatenstreaming aus. Die Liste der Streaming-Konfigurationen wird angezeigt.

   

4. Aktivieren oder inaktivieren Sie eine Streaming-Konfiguration über die Umschaltfläche.

Streaming-Konfigurationen auflisten

Verwenden Sie diese Methode, um die Details für alle vorhandenen Streaming-Konfigurationen abzurufen.

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

Wo

• <ENDPOINT> gibt den Endpunkt an, den der REST-API-Aufruf zum Ziel hat. Weitere Informationen finden Sie unter Monitoring-REST-API-Endpunkte. Der öffentliche Endpunkt für eine Instanz, die in der Region 'us-south' verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> ist das API-Token, das Sie für die Authentifizierung beim Monitoring-Service verwenden. Sie müssen Bearer in das Token einbeziehen. Weitere Informationen finden Sie unter Mit Monitoring-API-Tokens arbeiten.

Die Antwort wird ähnlich wie die folgenden sein:

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

Details zu einer Streaming-Konfiguration abrufen

Verwenden Sie diese Methode, um die Details für eine vorhandene Streaming-Konfiguration abzurufen.

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

Wo

• <ENDPOINT> steht für den Endpunkt, den der REST-API-Aufruf zum Ziel hat. Weitere Informationen finden Sie unter Monitoring-REST-API-Endpunkte. Der öffentliche Endpunkt für eine Instanz, die in der Region 'us-south' verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> ist das API-Token, das Sie für die Authentifizierung beim Monitoring-Service verwenden. Sie müssen Bearer in das Token einbeziehen. Weitere Informationen finden Sie unter Mit Monitoring-API-Tokens arbeiten.
• <STREAMING_CONFIG_ID> steht für die UUID der Streaming-Konfiguration, für die Sie Details abrufen möchten.

Die Antwort wird ähnlich wie die folgenden sein:

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

Streaming-Konfiguration erstellen

Verwenden Sie diese Methode, um eine Streaming-Konfiguration zu konfigurieren, die eine Gruppe von Metriken an Event Streams weiterleitet.

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

Wo

• <ENDPOINT> steht für den Endpunkt, den der REST-API-Aufruf zum Ziel hat. Weitere Informationen finden Sie unter Monitoring-REST-API-Endpunkte. Der öffentliche Endpunkt für eine Instanz, die in der Region 'us-south' verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> ist das API-Token, das Sie für die Authentifizierung beim Monitoring-Service verwenden. Sie müssen Bearer in das Token einbeziehen. Weitere Informationen finden Sie unter Mit Monitoring-API-Tokens arbeiten.

Eine streaming-config.json-Beispieldatei sieht wie folgt aus:

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

Streaming-Konfiguration aktualisieren

In jedem der folgenden Fälle muss die Streaming-Konfiguration aktualisiert werden:

• Der API-Schlüssel für die Authentifizierung bei Event Streams wurde turnusmäßig gewechselt (Rotation), seine Sicherheit ist beeinträchtigt oder er muss geändert werden.
• Sie möchten Änderungen an den Metriken, die Sie per Streaming übertragen, entweder durch Hinzufügen neuer Metriken oder durch Entfernen vorhandener Metriken vornehmen.
• Sie müssen den Geltungsbereich ändern.
• Sie möchten das Daten-Streaming für die Konfiguration aktivieren oder inaktivieren.

Verwenden Sie diese Methode, um eine Streaming-Konfiguration zu konfigurieren, die eine Gruppe von Metriken an Event Streams weiterleitet.

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

Wo

• <ENDPOINT> steht für den Endpunkt, den der REST-API-Aufruf zum Ziel hat. Weitere Informationen finden Sie unter Monitoring-REST-API-Endpunkte. Der öffentliche Endpunkt für eine Instanz, die in der Region 'us-south' verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> ist das API-Token, das Sie für die Authentifizierung beim Monitoring-Service verwenden. Sie müssen Bearer in das Token einbeziehen. Weitere Informationen finden Sie unter Mit Monitoring-API-Tokens arbeiten.
• <STREAMING_CONFIG_ID> steht für die UUID der Streaming-Konfiguration.

Eine streaming-config.json-Beispieldatei sieht wie folgt aus:

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

Streaming-Konfiguration löschen

Verwenden Sie diese Methode, um eine Streaming-Konfiguration zu konfigurieren, die eine Gruppe von Metriken an Event Streams weiterleitet.

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

Wo

• <ENDPOINT> steht für den Endpunkt, den der REST-API-Aufruf zum Ziel hat. Weitere Informationen finden Sie unter Monitoring-REST-API-Endpunkte. Der öffentliche Endpunkt für eine Instanz, die in der Region 'us-south' verfügbar ist, ist beispielsweise folgender: https://us-south.monitoring.cloud.ibm.com/api
• <TOKEN> ist das API-Token, das Sie für die Authentifizierung beim Monitoring-Service verwenden. Sie müssen Bearer in das Token einbeziehen. Weitere Informationen finden Sie unter Mit Monitoring-API-Tokens arbeiten.
• <STREAMING_CONFIG_ID> steht für die UUID der Streaming-Konfiguration.