Aktionen in IBM Cloud Logs für die Integration mit Services anderer Anbieter verwenden

Unter IBM Cloud Logs können Sie auf der Grundlage Ihrer Suchergebnisse und -werte Dienste von Drittanbietern auslösen und Daten an diese Dienste senden. Sie können Verwaltungsaktionen aus Ansichten und Dashboards erstellen.

Aktion erstellen

So erstellen Sie eine Aktion:

Klicken Sie in der linken Navigation auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie in der Ansicht Protokolle auf Einstellungen. Dieses Einstellungssymbol ist nicht mit dem Symbol in der linken Navigation identisch. Das Symbol für Einstellungen befindet sich in der Ansicht 'Protokolle' oben rechts auf der Seite.
Klicken Sie auf Aktionen verwalten.
Klicken Sie auf Neue Aktion hinzufügen.
Geben Sie für Unbenannte Aktion einen Namen für Ihre Aktion an.
Geben Sie im URL TEMPLATE die URL für den externen Dienst ein. Beispiel: https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}. Nur http:// und https:// werden unterstützt.

JavaScript-Syntax wird unterstützt. Sie können beispielsweise Bedingungen wie {{ condition ? "true value" : "false value" }} angeben. Die meisten JavaScript-Funktionen werden unterstützt.

Sie können Variablen einfügen, um Daten an die URL zu übergeben. Wenn Sie doppelte geschweifte Klammern ({{}}) eingeben, wird eine Liste der verfügbaren Variablen angezeigt.
Wählen Sie den Datentyp aus, der der Aktion zugeordnet ist. Die Aktion wird im ausgewählten Kontext angezeigt.
Klicken Sie auf Erweitert, um auf optionale Einstellungen zuzugreifen.
Um die Aktion öffentlich zu machen, aktivieren Sie Beim Speichern öffentlich machen.
Wählen Sie Werte aus der Liste aus, um die Aktion auf bestimmte Anwendungen oder Subsysteme zu begrenzen.
Klicken Sie auf Aktion speichern.

Aktion bearbeiten

Um eine bestehende Aktion zu bearbeiten:

Klicken Sie in der linken Navigation auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie in der Ansicht Protokolle auf Einstellungen. Dieses Einstellungssymbol ist nicht mit dem Symbol in der linken Navigation identisch. Das Symbol für Einstellungen befindet sich in der Ansicht 'Protokolle' oben rechts auf der Seite.
Klicken Sie in der Liste der Aktionen auf die zu ändernde Aktion.
Nehmen Sie Ihre Änderungen vor.
Klicken Sie auf Aktion speichern, um Ihre Änderungen zu sichern, oder auf Zurücksetzen, um die Aktion auf die zuletzt gespeicherte Version der Aktion zurückzusetzen.

Aktion klonen

Wenn Sie eine neue Aktion auf der Basis einer vorhandenen Aktion erstellen möchten, können Sie eine Aktion klonen.

Klicken Sie im linken Navigationsbereich auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie in der Ansicht Protokolle auf Einstellungen. Dieses Einstellungssymbol ist nicht mit dem Symbol in der linken Navigation identisch. Das Symbol für Einstellungen befindet sich in der Ansicht 'Protokolle' oben rechts auf der Seite.
Bewegen Sie in der Liste der Aktionen den Mauszeiger über die Aktion, die Sie klonen wollen.
Klicken Sie auf das Symbol Klonen. Ein Duplikat Ihrer Aktion wird erstellt.
Bearbeiten Sie die geklonte Aktion und nehmen Sie Ihre Änderungen vor.
Klicken Sie auf Aktion speichern, um Ihre Änderungen zu speichern.

Aktionen im Aktionsmenü anzeigen und ausblenden

Sie können konfigurieren, ob Aktionen von Benutzern ausgelöst werden können.

Klicken Sie in der linken Navigation auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie in der Ansicht Protokolle auf Einstellungen. Dieses Einstellungssymbol ist nicht mit dem Symbol in der linken Navigation identisch. Das Symbol für Einstellungen befindet sich in der Ansicht 'Protokolle' oben rechts auf der Seite.
Klicken Sie in der Liste der Aktionen auf die Aktion, die Sie konfigurieren möchten.
Klicken Sie auf das Symbol Aus Aktionsmenü ausblenden, damit die Aktion nicht für Benutzer im Aktionsmenü enthalten ist. Klicken Sie auf das Symbol In Aktionsmenü anzeigen, um die Aktion in das Aktionsmenü aufzunehmen.

Aktion auslösen

Führen Sie die folgenden Schritte aus, um eine Aktion auszulösen:

Klicken Sie in der linken Navigation auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie auf angezeigte Daten in der Ansicht. Es wird ein Menü eingeblendet.
Bewegen Sie den Mauszeiger über Aktionen. Die Liste der verfügbaren Aktionen wird angezeigt.
Klicken Sie auf die Aktion, um sie auszulösen.

Nur Aktionen, die für die Anzeige im Aktionsmenü konfiguriert sind, werden im Aktionsmenü aufgelistet.

Aktion löschen

Klicken Sie in der linken Navigation auf das Symbol Protokolle durchsuchen > Protokolle.
Klicken Sie in der Ansicht Protokolle auf Einstellungen. Dieses Einstellungssymbol ist nicht mit dem Symbol in der linken Navigation identisch. Das Symbol für Einstellungen befindet sich in der Ansicht 'Protokolle' oben rechts auf der Seite.
Klicken Sie in der Liste der Aktionen auf die zu löschende Aktion.
Klicken Sie auf Löschen.

Die Löschung erfolgt sofort. Sie werden nicht aufgefordert, das Löschen der Aktion zu bestätigen.

Variablen, die in eine Aktion eingeschlossen werden können

Sie können in einer URL Vorlage Variablen angeben, um Informationen an Ihren externen Dienst zu übergeben.

Die folgenden Variablen werden unterstützt:

$m.<metadata>: Metadatenvariablen sind in den Protokollen verfügbar. Beispiel: $m.applicationName oder $m.timestamp.
$d.<key>.<subkey>: Im Protokoll verfügbare Daten. Beispiel: $d.kubernetes.labels.my_label.
$p.start_time: Der Beginn des ausgewählten Zeitbereichs als Unix epoch timestamp in Millisekunden.
$p.end_time: Das Ende des ausgewählten Zeitbereichs als Unix Epochenzeitstempel in Millisekunden.
$p.selected_value: Der vom Benutzer in der Benutzerschnittstelle ausgewählte Wert. Bei Aktivierung durch Klicken auf einen Schlüssel wird der gesamte Wert des Schlüssels eingeschlossen.

Beispielaktion

Die folgende Aktion generiert ein Jira-Problem.

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}