Szenario: Streamingdaten an Log Analytics senden

Erfahren Sie, wie Sie Streamingdaten vom OCI Streaming-Service mit Connector Hub an Log Analytics senden. Streaming nimmt Datenströme mit hohem Volumen in Echtzeit auf und verbraucht sie.

Erforderliche IAM-Policy

Standard-Policys bieten Ihnen den benötigten Zugriff. Der Workflow zum Erstellen eines Connectors mit einer Streamingquelle und einem Log Analytics-Ziel umfasst eine Standard-Policy zum Lesen von Streams und eine Standard-Policy zum Schreiben in Log Analytics. Informationen zu Policys finden Sie unter Überblick über IAM-Policys.

Ziel

Ziel dieses Szenarios ist die Analyse von Streamdaten.

Szenario einrichten

Beim Einrichten dieses Szenarios wird ein Connector erstellt, um Streams zur Analyse in Log Analytics zu verschieben.

Sie können diese Aufgaben in der Oracle Cloud Infrastructure-Konsole, in der CLI oder in der API ausführen.

Konsole verwenden

Öffnen Sie das Navigationsmenü , und wählen Sie Analysen und KI aus. Wählen Sie unter Messaging die Option Connector-Hub aus.
Wählen Sie das Compartment aus, in dem Sie den Connector erstellen möchten.
Wählen Sie Connector erstellen aus.
Verschieben Sie auf der Seite Connector erstellen streams in Log Analytics:
1. Geben Sie einen Connector-Namen ein. Geben Sie dabei keine vertraulichen Informationen ein. Beispiel: "Metriken in Bucket"
2. Wählen Sie das Ressourcen-Compartment aus, in dem Sie den neuen Connector speichern möchten.
3. Wählen Sie unter Connector konfigurieren den Quell- und Zielservice aus, um Logdaten in eine Metrik zu verschieben:
  - Quelle: Streaming
  - Ziel: Logging Analytics
4. Wählen Sie unter Quelle konfigurieren den Stream aus:
  - Compartment: Wählen Sie das Compartment aus, das den Stream enthält.
  - Streampool: Wählen Sie den Namen des Streampools aus, der den Stream enthält.
  - Stream: Wählen Sie den Namen des Streams aus, von dem Sie Daten empfangen möchten.
  - Leseposition: Wählen Sie Letzte aus, um mit dem Lesen in Nachrichten zu beginnen, die nach dem Speichern des Connectors veröffentlicht wurden.
5. Überspringen Sie die optionale Aufgabe (Konfiguration der Aufgabe).
6. Wählen Sie unter Ziel konfigurieren die Loggruppe und Quelle aus, in die Sie den Stream verschieben möchten:
  - Compartment: Wählen Sie das Compartment aus, das die Loggruppe enthält.
  - Loggruppe: Wählen Sie die Loggruppe aus, die Sie möchten.
  - Logquellen-ID: Wählen Sie die gewünschte Logquelle aus.
Wenn Sie aufgefordert werden, eine Policy zu erstellen (erforderlich, damit der Connector auf Quell-, Aufgaben- und Zielservices zugreift), wählen Sie Erstellen aus.
Klicken Sie auf Erstellen.

Der neue Connector beginnt sofort, den Stream in die ausgewählte Loggruppe und Quelle zu verschieben.

CLI verwenden

Definieren Sie die Streamingquelle für den Connector: Speichern Sie eine Datei namens source.json.
Beispiel für eine source.json-Datei
```
{
  "kind": "streaming",
  "streamId": "<stream_OCID>",
  "cursor" : {
      "kind": "LATEST"
  }
}
```
Definieren Sie das Object Storage-Ziel für den Connector: Speichern Sie eine Datei mit dem Namen target.json.
Beispiel für eine target.json-Datei
```
{
 "kind": "loggingAnalytics",
 "logGroupId": "<log_group_OCID>",
 "logSourceIdentifier": "<log_source_name>"
}
```
Erstellen Sie den Connector mit dem Befehl oci sch service-connector create:
Beispielbefehl zum Erstellen eines Connectors
oci sch service-connector create --compartment-id <compartment_OCID> --display-name "Stream to Log Analytics" --source file://source.json --target file://target.json
Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.
Hilfe zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Connectors und Fehlerbehebung bei Notifications.

Eine vollständige Liste der Kennzeichen und Variablenoptionen für CLI-Befehle finden Sie in der Befehlszeilenreferenz.

Hilfe zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Connectors und Fehlerbehebung bei Notifications.

API verwenden

Verwenden Sie den Vorgang CreateServiceConnector, um den Connector zu erstellen.

Beispiel für eine CreateServiceConnector-Anforderung

POST /20200909/serviceConnectors
Host: service-connector-hub.us-phoenix-1.oraclecloud.com
<authorization and other headers>
{
  "compartmentId": "<compartment_OCID>",
  "displayName": "Stream to Log Analytics",
  "source": {
    "kind": "streaming",
    "streamId": "<stream_OCID>",
    "cursor" : {
        "kind": "LATEST"
    }
  },
  "target": {
   "kind": "loggingAnalytics",
   "logGroupId": "<log_group_OCID>",
   "logSourceIdentifier": "<log_source_name>"
  }
}