Esempi per CloudWatch Logs con AWS CLI - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi per CloudWatch Logs con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con CloudWatch Logs.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare create-log-group.

AWS CLI

Il comando seguente crea un gruppo di log denominato my-logs.

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

  • Per informazioni dettagliate sull’API, consulta CreateLogGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-log-stream.

AWS CLI

Il comando seguente crea un flusso di log denominato 20150601 nel gruppo di log my-logs.

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

  • Per informazioni dettagliate sull’API, consulta CreateLogStream in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-log-group.

AWS CLI

Il comando seguente elimina un gruppo di log denominato my-logs.

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

  • Per informazioni dettagliate sull’API, consulta DeleteLogGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-log-stream.

AWS CLI

Il comando seguente elimina un flusso di log denominato 20150531 da un gruppo di log denominato my-logs:

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

  • Per informazioni dettagliate sull’API, consulta DeleteLogStream in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-retention-policy.

AWS CLI

Il comando seguente rimuove la policy di conservazione precedentemente applicata a un gruppo di log denominato my-logs:

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

L’esempio di codice seguente mostra come utilizzare describe-log-groups.

AWS CLI

Il comando seguente descrive un gruppo di log denominato my-logs.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta DescribeLogGroups in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-log-streams.

AWS CLI

Il comando seguente mostra tutti i flussi di log che iniziano con il prefisso 2015 nel gruppo di log my-logs.

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

Output:

{
    "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
        }
    ]
}

  • Per informazioni dettagliate sull’API, consulta DescribeLogStreams in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-log-events.

AWS CLI

Il comando seguente recupera gli eventi del log da un flusso di log denominato 20150601 nel gruppo di log my-logs.

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

Output:

{
    "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"
}

  • Per informazioni dettagliate sull’API, consulta GetLogEvents in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-log-events.

AWS CLI

Il comando seguente inserisce gli eventi di log in un flusso di log denominato 20150601 nel gruppo di log my-logs:

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

Output:

{
    "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}

L’esempio precedente legge un array di eventi JSON da un file denominato events nella directory corrente:

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

Ogni chiamata successiva richiede che il token di sequenza successivo fornito dalla chiamata precedente venga specificato con l’opzione del token della sequenza:

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

Output:

{
    "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}

  • Per informazioni dettagliate sull’API, consulta PutLogEvents in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-retention-policy.

AWS CLI

Il comando seguente aggiunge una policy di conservazione di 5 giorni a un gruppo di log denominato my-logs:

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

  • Per informazioni dettagliate sull’API, consulta PutRetentionPolicy in AWS CLI Command Reference.