Esempio: conteggio delle occorrenze di un termine - CloudWatch Registri Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempio: conteggio delle occorrenze di un termine

Gli eventi di log includono spesso messaggi importanti che desideri contare, forse per quel che concerne il successo o il fallimento delle operazioni. Ad esempio, se una determinata operazione non riesce, potrebbe verificarsi un errore che viene registrato in un file di log. Potresti voler monitorare queste voci per comprendere l'andamento dei tuoi errori.

Nell'esempio sottostante, una filtro parametri viene creato per monitorare il termine Error. La policy è stata creata e aggiunta al gruppo di log /message.log. MyApp CloudWatch Logs pubblica un punto dati nella metrica CloudWatch personalizzata ErrorCount nello spazio dei nomi MyApp/message.log con un valore di «1" per ogni evento contenente Error. Se nessun evento contiene la parola Error, il valore pubblicato è 0. Quando rappresentate graficamente questi dati nella CloudWatch console, assicuratevi di utilizzare la statistica della somma.

Dopo aver creato un filtro metrico, puoi visualizzare la metrica nella console. CloudWatch Quando si seleziona il parametro da visualizzare, selezionare lo spazio dei nomi del parametro che corrisponde al nome del gruppo di log. Per ulteriori informazioni, consulta Visualizzazione dei parametri disponibili.

Per creare un filtro metrico utilizzando la console CloudWatch
  1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel pannello di navigazione, selezionare Log groups (Gruppi di log).

  3. Scegli il nome del gruppo di log.

  4. Scegliere Operazioni, Crea filtro parametri.

  5. In Modello di filtro, immettere Error.

    Nota

    Tutte le voci in Filtra Pattern (Modello File) fanno distinzione tra lettere maiuscole e minuscole.

  6. (Facoltativo) Per testare il modello di filtro, in Test Pattern (Modello di test), inserisci uno o più log eventi da utilizzare per testare il modello. Ogni log eventi deve essere all'interno di una riga, in quanto le interruzioni di riga vengono utilizzate per separare i log eventi nella casella Log event messages (Messaggi di registro eventi).

  7. Scegliere Avanti, quindi nella pagina Assegna parametro, per Nome filtro, digitare MyAppErrorCount.

  8. In Metric Details, per Metric Namespace, digitate. MyNameSpace

  9. Per Metric Name (Nome parametro) digita ErrorCount.

  10. Verificare che il Valore parametro sia 1. Questo specifica che il conteggio viene incrementato di 1 per ogni log eventi contente "Error".

  11. Per Valore predefinito digitare 0, quindi scegliere Avanti.

  12. Scegli Crea filtro parametri.

Per creare un filtro metrico utilizzando il AWS CLI

Al prompt dei comandi, esegui il comando seguente:

aws logs put-metric-filter \ --log-group-name MyApp/message.log \ --filter-name MyAppErrorCount \ --filter-pattern 'Error' \ --metric-transformations \ metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0

Puoi verificare questa nuova policy pubblicando eventi che contengano la parola "Error" nel messaggio.

Per pubblicare eventi utilizzando il AWS CLI

Al prompt dei comandi, esegui il comando seguente. Nota che i modelli fanno distinzione tra lettere maiuscole e minuscole.

aws logs put-log-events \ --log-group-name MyApp/access.log --log-stream-name TestStream1 \ --log-events \ timestamp=1394793518000,message="This message contains an Error" \ timestamp=1394793528000,message="This message also contains an Error"