Vorbereitende Schritte

1. Wenn Sie noch kein IBM Cloud Konto haben, registrieren Sie ein IBM Cloud Konto. Sie benötigen eine IBMid, um in IBM Cloud arbeiten zu können.

2. Überprüfen Sie, in welchen Regionen der Service IBM Cloud Logs Routing verfügbar ist.

3. Vergewissern Sie sich, dass der Benutzer, der IBM Cloud Logs Routing für das Konto IBM Cloud® konfiguriert, über ausreichende Berechtigungen zur Verwaltung des Dienstes IBM Cloud Logs Routing verfügt. Weitere Informationen finden Sie unter Verwalten des IAM-Zugriffs für IBM Cloud Logs Routing.

   Sie benötigen die Plattformrolle Adminsitrator, um Ressourcen zu verwalten.

4. Installieren Sie die folgenden Tools:

   • Laden Sie die IBM Cloud®-Befehlszeilenschnittstelle herunter und installieren Sie diese.

   • Laden Sie jq herunter und installieren Sie es, um die Ausgabe zu verarbeiten und die gewünschten Ergebnisse abzufragen.

5. Bereitstellung einer IBM Cloud Logs-Instanz oder Zugang zu einer solchen. Weitere Informationen finden Sie unter Instanz bereitstellen.

Erstellen einer Dienst-zu-Dienst-Autorisierung

Sie müssen IBM Cloud® Identity and Access Management (IAM) verwenden, um eine Berechtigung zu erstellen, die IBM Cloud Logs Routing Zugriff auf IBM Cloud Logs gewährt, damit der Dienst IBM Cloud Logs Routing Protokolle an das Ziel (Target) Ihrer Instanz IBM Cloud Logs senden kann.

Sie müssen die Absenderrolle für IBM Cloud Logs haben, bevor Sie den Dienst für die Dienstautorisierung konfigurieren.

Führen Sie die folgenden Schritte aus:

1. Klicken Sie in der IBM Cloud-Konsole auf Verwalten > Zugriff (IAM) und wählen Sie Autorisierungen aus.

2. Klicken Sie auf Erstellen.

3. Konfigurieren Sie das Quellkonto. Wählen Sie dieses Konto.

4. Wählen Sie Logs Routing als Quelldienst. Legen Sie dann den Zugriffsbereich auf Alle Ressourcen fest.

5. Wählen Sie Cloud Logs als Zieldienst aus. Legen Sie dann den Zugriffsbereich auf Alle Ressourcen fest, was den Zugriff auf alle IBM Cloud Logs Instanzen gewährt, oder auf eine einzelne Instanz, indem Sie Ressourcen basierend auf ausgewählten Attributen > Dienstinstanz konfigurieren.

   Andere Attribute werden für diese Art der Berechtigung nicht unterstützt.

6. Wählen Sie im Abschnitt Dienstzugriff die Option Sender, um dem Quelldienst, der auf den Zieldienst zugreift, Zugriff zu gewähren.

7. Klicken Sie auf Autorisieren.

Weitere Informationen finden Sie unter Erstellen einer S2S Berechtigung, um Zugriff auf das Senden von Protokollen an IBM Cloud Logs zu gewähren.

Konfigurieren Sie den Speicherort der primären Metadaten und die API-Version

Führen Sie die folgenden Schritte aus:

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung >Routing.

4. Klicken Sie auf die Registerkarte Einstellungen.

5. Klicken Sie auf Bearbeiten neben der zu ändernden Einstellung.

   Geben Sie einen Speicherort für primäre Metadaten ein.

   Setzen Sie die API-Version auf 3.

Ziel erstellen

Führen Sie die folgenden Schritte aus, um ein Ziel zu erstellen:

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Wählen Sie Protokollierung > Routing.

4. Klicken Sie im Abschnitt Ziele auf Erstellen, um das Erstellungsfenster zu öffnen.

5. Wählen Sie im Feld Ziel auswählen die Option Nach Instanz suchen oder CRN angeben.

   Wählen Sie Suche nach Instanz, um eine IBM Cloud Logs Instanz aus der Tabelle auszuwählen, die im Konto verfügbar ist

   Wählen Sie CRN angeben, um die IBM Cloud Logs Instanz-CRN einer Instanz hinzuzufügen, die sich in einem anderen Konto befindet.

6. Führen Sie im Abschnitt Zieldetails die folgenden Aufgaben aus:

   Geben Sie den Zielnamen ein.

   Aktivieren Sie die Umschaltfunktion von Nicht festgelegt, um Ihr neues Ziel automatisch als Standardziel in Ihren IBM Cloud Logs Routing Einstellungen festzulegen.

7. Klicken Sie auf Ziel erstellen.

Konfigurieren Sie eine Route

Führen Sie die folgenden Schritte aus, um ein Ziel zu erstellen:

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung > Routing.

4. Klicken Sie auf der Registerkarte " Routen" auf Erstellen.

5. Ändern Sie im Abschnitt Routingregeln die Aktion für Regel 1:

   Wählen Sie eine Aktion für Regel 1:

   • Wählen Sie Protokolle senden von für die Regel, um Plattformprotokolle an die zugehörigen Ziele weiterzuleiten.

   • Wählen Sie Protokolle verwerfen von für die Regel, um Plattformprotokolle zu verwerfen, die dieser Regel entsprechen.

   Fügen Sie die Einschlussfilter hinzu, um die Plattformprotokolle zu bestimmen, die an die in der Regel angegebenen Ziele weitergeleitet werden.

   • Wählen Sie eine Bedingung aus, und geben Sie die Ortswerte an, auf die der Einschlussfilter zutreffen soll.

   • Um mehrere Einschlussfilter hinzuzufügen, klicken Sie auf Filter hinzufügen, um weitere Filter hinzuzufügen.

   Fügen Sie die Ziele hinzu, die mit der Regel verknüpft werden sollen, indem Sie ein Ziel aus der Liste auswählen. Wenn Sie noch kein Ziel definiert haben, klicken Sie auf Ziel hinzufügen, um ein neues Ziel zu erstellen.

6. Klicken Sie auf Regel hinzufügen, um der Route weitere Regeln hinzuzufügen.

   Die Reihenfolge der Routenregeln beeinflusst das Routingverhalten. Die Regeln werden der Reihe nach abgearbeitet. Sobald eine Regel erfüllt ist, werden die nachfolgenden Regeln nicht mehr abgearbeitet.

   Die Reihenfolge der Routing-Regeln kann durch Klicken auf die Auf- und Abwärtspfeile rechts neben jeder Regeldefinition geändert werden.

   Wenn Sie eine Regel oder einen Filter entfernen möchten, klicken Sie auf das Symbol Entfernen, das mit der Regel oder dem Filter verbunden ist.

   Sie können bis zu 10 Regeln pro Route konfigurieren.

7. Klicken Sie auf Weiter.

8. Geben Sie einen Namen für die Route ein.

9. Überprüfen Sie die Streckendefinition, um sicherzustellen, dass die Reihenfolge der Regeln wie vorgesehen ist.

   Weitere Informationen finden Sie unter Routing-Priorität verstehen.

10. Klicken Sie auf Erstellen.

Überprüfung, ob die Protokolle an das Ziel gesendet werden

Vergewissern Sie sich, dass die Protokolle an Ihre Instanz IBM Cloud Logs weitergeleitet werden.

Führen Sie die folgenden Schritte aus:

1. Starten Sie die Web-UI IBM Cloud Logs für die Instanz IBM Cloud Logs, die als Ziel für die Erfassung von Plattformprotokollen in einer Region konfiguriert ist. Dies ist die Instanz, die Sie in dem Schritt, in dem Sie ein Ziel einrichten, ausgewählt haben.

2. Anzeigen von Protokollen über benutzerdefinierte Ansichten. Weitere Informationen finden Sie unter Protokolle anzeigen.

   Alle Plattformprotokolle werden in JSON generiert. Sie können Plattformprotokolle in Ihrer Instanz filtern, indem Sie den Wert von ibm-platform-logs als applicationName auswählen oder die Lucene-Abfrage ausführen: coralogix.metadata.applicationName:"ibm-platform-logs"