IBM Cloud Logs-Befehlszeilenschnittstelle (CLI)

Sie können die Befehlszeilenschnittstelle (CLI) von IBM® Cloud Logs verwenden, um Ihre IBM Cloud Logs-Instanz zu verwalten.

Voraussetzungen

  • Installieren Sie die IBM Cloud-CLI.

  • Installieren Sie das IBM Cloud Logs-CLI-Plug-in, indem Sie den folgenden Befehl ausführen:

    ibmcloud plugin install logs
    

    Sie werden über die Befehlszeile benachrichtigt, wenn Aktualisierungen für die IBM Cloud-CLI und -Plug-ins verfügbar sind. Stellen Sie sicher, dass die Befehlszeilenschnittstelle auf dem neuesten Stand ist, damit Sie die aktuellen Befehle nutzen können. Sie können die aktuelle Version aller installierten Plug-ins anzeigen, indem Sie den Befehl ibmcloud plugin list ausführen.

  • Um die IBM Cloud Logs Verwenden Sie beispielsweise eine der folgenden Optionen.

    Option 1: Führen Sie den ibmcloud logs config set Befehl.

    ibmcloud logs config set service-url https://{API_endpoint}
    

    Option 2: Exportieren Sie eine Umgebungsvariable mit Ihrem Endpunkt für den IBM Cloud Logs-Dienst URL.

    export LOGS_URL=https://{API_endpoint}
    

    Option 3: Legen Sie den Service-Endpunkt im Befehl fest.

    ibmcloud logs --service-url https://{API_endpoint}
    

    Ersetzen Sie " {API_endpoint} durch den API-Endpunkt, der für Ihre Instanz spezifisch ist. Die API-Endpunktinformationen können von der Seite mit den Dienstdetails in der IBM Cloud Logs BENUTZEROBERFLÄCHE.

Befehle

Die derzeit unterstützte Version der IBM Cloud Logs-CLI ist 0.3.0. Falls eine andere Version installiert ist, deinstallieren Sie das installierte Plug-in und installieren Sie das aktuelle IBM Cloud Logs-CLI-Plug-in.

Sowohl als auch ibmcloud cloud-logs ibmcloud logs können zum Ausführen von IBM Cloud Logs-CLI-Befehlen verwendet werden.

IBM Cloud Logs alert CLI-Befehle
Befehl Beschreibung
alert Erhalten Sie eine Benachrichtigung per ID.
alert-create Erstellen Sie einen Alarm.
alert-delete Alert löschen.
alert-update Aktualisieren Sie eine Warnung.
alerts Listenwarnungen.
IBM Cloud Logs cLI-Befehle zur Alarmdefinition
Befehl Beschreibung
alert-definition Erhalten Sie eine Alarmdefinition nach ID.
alert-definition-create Erstellen Sie eine Alarmdefinition.
alert-definition-delete Löschen einer Alarmdefinition nach ID.
alert-definition-update Aktualisieren Sie eine Alarmdefinition nach ID.
alert-definitions Liste der Alarmdefinitionen.
IBM Cloud Logs hintergrundabfrage (asynchrone Archivabfrage) CLI-Befehle
Befehl Beschreibung
background-query-cancel, bgq-cancel Abbrechen einer Hintergrundabfrage.
background-query-create, bgq-create Übermitteln Sie eine Hintergrundabfrage, die asynchron verarbeitet werden soll.
background-query-data, bgq-data Daten der Hintergrundabfrage zur Suche in den Protokollen.
background-query-status, bgq-status Abrufen des Status einer Hintergrundabfrage.
IBM Cloud Logs cLI-Befehle für Datenzugriffsregeln
Befehl Beschreibung
data-access-rule-create Erstellen Sie eine Datenzugriffsregel.
data-access-rule-delete Löschen Sie eine Datenzugriffsregel.
data-access-rule-update Eine Datenzugriffsregel aktualisieren.
data-access-rules Abrufen der Datenzugriffsregeln einer Dienstinstanz nach ID.
IBM Cloud Logs cLI-Befehle zur Datennutzung
Befehl Beschreibung
data-usage Erhalten Sie den täglichen und detaillierten Datenverbrauch.
data-usage-metrics-export-status Rufen Sie den Exportstatus der Datennutzungsmetriken ab.
data-usage-metrics-export-status-update Aktualisieren Sie den Exportstatus der Datennutzungsmetriken.
IBM Cloud Logs anreicherungs-CLI-Befehle
Befehl Beschreibung
enrichment-create Schaffen Sie eine Bereicherung.
enrichment-delete Anreicherungen löschen.
enrichments Alle Anreicherungen auflisten.
IBM Cloud Logs Event Streams integration CLI-Befehle
Befehl Beschreibung
event-stream-target-create Erstellen Sie eine IBM Event Streams for IBM Cloud Integration.
event-stream-target-delete Löschen Sie eine Event Streams Integration nach ID.
event-stream-target-update Aktualisieren Sie eine Event Streams Integration.
event-stream-targets Alle Event Streams-Integrationen auflisten.
IBM Cloud Logs ereignisse zu Metriken CLI-Befehle
Befehl Beschreibung
events2metrics, e2m Ruft die Metrikdefinitionen der Ereignisse anhand ihrer ID ab.
events2metrics-create, e2m-create Erzeugt die Ereignisse zu den Metrikdefinitionen.
events2metrics-delete, e2m-delete Löscht die Definitionen von Ereignissen zu Metriken anhand ihrer ID.
events2metrics-list, e2m-list Listet die Ereignisse zu Metrikdefinitionen auf.
events2metrics-update, e2m-update Aktualisiert die Ereignisse in den Metrikdefinitionen.
IBM Cloud Logs cLI-Befehle für die ausgehende Integration
Befehl Beschreibung
outgoing-webhook Ruft eine ausgehende Integration per ID ab.
outgoing-webhook-create Erstellen Sie eine ausgehende Integration.
outgoing-webhook-delete Löschen Sie eine ausgehende Integration.
outgoing-webhook-update Aktualisieren Sie eine ausgehende Integration.
outgoing-webhooks Listen Sie ausgehende Integrationen auf.
IBM Cloud Logs richtlinien-CLI-Befehle
Befehl Beschreibung
policies Ruft Richtlinien ab.
policy Ruft die Richtlinie nach ID ab.
policy-create Erstellt eine neue Richtlinie.
policy-delete Löscht eine vorhandene Richtlinie.
policy-update Aktualisiert eine vorhandene Richtlinie.
IBM Cloud Logs cLI-Befehle abfragen
Befehl Beschreibung
query Führen Sie eine Abfrage aus, um die Protokolle zu durchsuchen.
IBM Cloud Logs regeln CLI-Befehle
Befehl Beschreibung
rule-group Ruft eine Regel anhand der groupid ab.
rule-group-create Erzeugt eine Regelgruppe.
rule-group-delete Löscht eine Regelgruppe anhand der Gruppen-ID.
rule-group-update Aktualisiert eine Regelgruppe anhand der Gruppen-ID.
rule-groups Ruft alle Regelgruppen ab.
IBM Cloud Logs cLI-Befehle anzeigen
Befehl Beschreibung
view Ruft eine Ansicht nach ID ab.
view-create Erstellt eine neue Ansicht.
view-delete Löscht eine Ansicht nach ID.
view-update Ersetzt eine vorhandene Ansicht.
views Listet alle öffentlichen Ansichten des Unternehmens auf.
IBM Cloud Logs ordner anzeigen CLI-Befehle
Befehl Beschreibung
view-folder Ansichtsordner abrufen.
view-folder-create Ansichtsordner erstellen.
view-folder-delete Löscht einen Ansichtsordner nach ID.
view-folder-update Ersetzt einen vorhandenen Ansichtsordner.
view-folders Ordner der Listenansicht.
IBM Cloud Logs Erweiterungen CLI-Befehle
Befehl Beschreibung
extensions Ruft eine Erweiterung anhand der ID ab.
extension-deployment Rufen Sie Details zur Bereitstellung über eine Erweiterung ab.
extension-deployment-delete Deployment einer Erweiterung löschen.
extension-deployment-managep Eine Erweiterung bereitstellen oder die Bereitstellung aktualisieren.
extensions Liste der Erweiterungen abrufen.
IBM Cloud Logs zusätzliche CLI-Befehle
Befehl Beschreibung
config Steuern Sie die dauerhafte Konfiguration.
help Hilfeinformationen anzeigen.

Weitere Informationen zur Verwendung dieser Befehle erhalten Sie, wenn Sie sich bei IBM Cloud und Renn ibmcloud logs command_name -h. Beispiel: ibmcloud logs views -h.