CloudWatch Log-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with CloudWatch Logs Aktionen ausführen und allgemeine Szenarien implementieren.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Aktionen

create-log-group

Das folgende Codebeispiel zeigt, wie Siecreate-log-group.

AWS CLI

Der folgende Befehl erstellt eine Protokollgruppe mit dem Namen my-logs.

aws logs create-log-group --log-group-name my-logs

• Einzelheiten zur API finden Sie CreateLogGroupin der AWS CLI Befehlsreferenz.

create-log-stream

Das folgende Codebeispiel zeigt die Verwendungcreate-log-stream.

AWS CLI

Im folgenden Beispiel wird ein Protokollstream mit dem Namen 20150601 in der Protokollgruppe my-logs erstellt.

aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601

• Einzelheiten zur API finden Sie CreateLogStreamin der AWS CLI Befehlsreferenz.

delete-log-group

Das folgende Codebeispiel zeigt die Verwendungdelete-log-group.

AWS CLI

Mit dem folgenden Befehl wird eine Protokollgruppe mit dem Namen my-logs gelöscht:

aws logs delete-log-group --log-group-name my-logs

• Einzelheiten zur API finden Sie DeleteLogGroupin der AWS CLI Befehlsreferenz.

delete-log-stream

Das folgende Codebeispiel zeigt die Verwendungdelete-log-stream.

AWS CLI

Mit dem folgenden Befehl wird der Protokollstream mit dem Namen 20150531 aus der Protokollgruppe my-logs gelöscht:

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531

• Einzelheiten zur API finden Sie DeleteLogStreamin der AWS CLI Befehlsreferenz.

delete-retention-policy

Das folgende Codebeispiel zeigt die Verwendungdelete-retention-policy.

AWS CLI

Mit dem folgenden Befehl wird die Aufbewahrungsrichtlinie entfernt, die zuvor auf eine Protokollgruppe mit dem Namen my-logs angewendet wurde:

aws logs delete-retention-policy --log-group-name my-logs

• Einzelheiten zur API finden Sie DeleteRetentionPolicyin der AWS CLI Befehlsreferenz.

describe-log-groups

Das folgende Codebeispiel zeigt die Verwendungdescribe-log-groups.

AWS CLI

Der folgende Befehl beschreibt eine Protokollgruppe mit dem Namen my-logs:

aws logs describe-log-groups --log-group-name-prefix my-logs

Ausgabe:

{
    "logGroups": [
        {
            "storedBytes": 0,
            "metricFilterCount": 0,
            "creationTime": 1433189500783,
            "logGroupName": "my-logs",
            "retentionInDays": 5,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
        }
    ]
}

• Einzelheiten zur API finden Sie DescribeLogGroupsin der AWS CLI Befehlsreferenz.

describe-log-streams

Das folgende Codebeispiel zeigt die Verwendungdescribe-log-streams.

AWS CLI

Der folgende Befehl zeigt alle Protokollstreams in der Protokollgruppe my-logs an, die mit dem Präfix 2015 beginnen:

aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015

Ausgabe:

{
    "logStreams": [
        {
            "creationTime": 1433189871774,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
            "logStreamName": "20150531",
            "storedBytes": 0
        },
        {
            "creationTime": 1433189873898,
            "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
            "logStreamName": "20150601",
            "storedBytes": 0
        }
    ]
}

• Einzelheiten zur API finden Sie DescribeLogStreamsin der AWS CLI Befehlsreferenz.

get-log-events

Das folgende Codebeispiel zeigt die Verwendungget-log-events.

AWS CLI

Der folgende Befehl ruft Protokollereignisse aus einem Protokollstream mit dem Namen 20150601 in der Protokollgruppe my-logs ab:

aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601

Ausgabe:

{
    "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
    "events": [
        {
            "ingestionTime": 1433190494190,
            "timestamp": 1433190184356,
            "message": "Example Event 1"
        },
        {
            "ingestionTime": 1433190516679,
            "timestamp": 1433190184356,
            "message": "Example Event 1"
        },
        {
            "ingestionTime": 1433190494190,
            "timestamp": 1433190184358,
            "message": "Example Event 2"
        }
    ],
    "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}

• Einzelheiten zur API finden Sie GetLogEventsin der AWS CLI Befehlsreferenz.

put-log-events

Das folgende Codebeispiel zeigt die Verwendungput-log-events.

AWS CLI

Mit dem folgenden Befehl werden Protokollereignisse im Protokollstream 20150601 in der Protokollgruppe my-logs gespeichert:

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

Ausgabe:

{
    "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}

Mit dem obigen Beispiel wird ein JSON-Array von Ereignissen aus einer Datei mit dem Namen events im aktuellen Verzeichnis gelesen:

[
  {
    "timestamp": 1433190184356,
    "message": "Example Event 1"
  },
  {
    "timestamp": 1433190184358,
    "message": "Example Event 2"
  },
  {
    "timestamp": 1433190184360,
    "message": "Example Event 3"
  }
]

Für jeden nachfolgenden Aufruf muss das nächste Sequenz-Token, das vom vorherigen Aufruf bereitgestellt wurde, mit der Sequenz-Token-Option angegeben werden:

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"

Ausgabe:

{
    "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}

• Einzelheiten zur API finden Sie PutLogEventsin der AWS CLI Befehlsreferenz.

put-retention-policy

Das folgende Codebeispiel zeigt die Verwendungput-retention-policy.

AWS CLI

Mit dem folgenden Befehl wird einer Protokollgruppe mit dem Namen my-logs eine Aufbewahrungsrichtlinie für 5 Tage hinzugefügt:

aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5

• Einzelheiten zur API finden Sie PutRetentionPolicyin der AWS CLI Befehlsreferenz.