Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat alarm pada log

Anda dapat membuat CloudWatch alarm yang memantau data log Anda dengan dua cara:

Buat Alarm Log

Buat Alarm Log

Anda dapat membuat CloudWatch alarm yang menggunakan kueri Wawasan CloudWatch Log untuk memantau data log secara langsung. Kueri berjalan pada jadwal menggunakan Kueri Terjadwal, dan alarm mengevaluasi hasil agregat terhadap ambang batas. Untuk informasi selengkapnya tentang cara kerja Alarm Log, lihatAlarm log.

Prasyarat

Sebelum membuat Alarm Log, Anda harus membuat peran IAM yang memberikan izin CloudWatch Log untuk menjalankan kueri terjadwal. Jika Anda juga ingin baris log disertakan dalam notifikasi Amazon SNS, Anda harus membuat peran kedua.

Peran eksekusi kueri terjadwal

Peran eksekusi kueri terjadwal memungkinkan CloudWatch Log menjalankan kueri atas nama Anda. Peran ini diperlukan untuk semua Alarm Log untuk menjalankan kueri terjadwal. Peran harus mempercayai kepala logs.amazonaws.com layanan.

Contoh berikut menunjukkan kebijakan kepercayaan untuk peran eksekusi kueri terjadwal.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "logs.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Contoh berikut menunjukkan kebijakan izin. Cakupan Resource ke ARN grup log yang ditargetkan kueri.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:StartQuery",
                "logs:StopQuery",
                "logs:GetQueryResults",
                "logs:DescribeLogGroups"
            ],
            "Resource": "arn:aws:logs:region:account-id:log-group:your-log-group:*"
        }
    ]
}

Peran baris log (opsional)

Peran baris log memungkinkan CloudWatch untuk mengambil baris log untuk pemberitahuan email Amazon SNS. Peran ini diperlukan hanya jika Anda menetapkan ActionLogLineCount ke nilai yang lebih besar dari 0. Peran harus mempercayai kepala cloudwatch.amazonaws.com layanan.

Contoh berikut menunjukkan kebijakan kepercayaan untuk peran baris log.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "cloudwatch.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Contoh berikut menunjukkan kebijakan izin untuk peran baris log. logs:GetQueryResultsIzin diperlukan untuk mengambil baris log. Cakupan Resource ke ARN grup log yang ditargetkan kueri.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:GetQueryResults"
            ],
            "Resource": "arn:aws:logs:region:account-id:log-group:your-log-group:*"
        }
    ]
}

Membuat Alarm Log menggunakan konsol

Langkah-langkah di bagian ini menjelaskan cara menggunakan CloudWatch konsol untuk membuat Alarm Log. Anda juga dapat menggunakan AWS CLI untuk membuat Alarm Log. Untuk informasi selengkapnya, lihat Membuat Alarm Log menggunakan AWS CLI.

Membuat Alarm Log menggunakan AWS CLI

Anda dapat menggunakan AWS CLI put-log-alarm perintah untuk membuat Alarm Log.

Contoh berikut membuat Alarm Log yang memantau jumlah kesalahan dalam grup log dan transisi ke ALARM status ketika hitungan melebihi 100 dalam 3 dari 5 eksekusi kueri.

aws cloudwatch put-log-alarm \
    --alarm-name "HighErrorCount" \
    --alarm-description "Alarm when error count exceeds 100" \
    --comparison-operator GreaterThanThreshold \
    --threshold 100 \
    --query-results-to-evaluate 5 \
    --query-results-to-alarm 3 \
    --treat-missing-data missing \
    --alarm-actions "arn:aws:sns:region:account-id:topic-name" \
    --scheduled-query-configuration '{
        "QueryString": "fields @timestamp, @message | filter @message like /ERROR/",
        "LogGroupIdentifiers": ["/aws/lambda/my-function"],
        "ScheduledQueryRoleARN": "arn:aws:iam::account-id:role/ScheduledQueryRole",
        "AggregationExpression": "count(*)",
        "ScheduleConfiguration": {
            "ScheduleExpression": "rate(10 minutes)",
            "StartTimeOffset": 600
        }
    }' \
    --action-log-line-count 5 \
    --action-log-line-role-arn "arn:aws:iam::account-id:role/LogLineRole"

Tabel berikut menjelaskan parameter kunci untuk put-log-alarm perintah.

Membuat Alarm Log menggunakan AWS CloudFormation

Anda dapat menggunakan jenis AWS::CloudWatch::LogAlarm sumber daya untuk membuat Alarm Log dalam AWS CloudFormation templat.

Contoh template berikut membuat Log Alarm yang memantau jumlah kesalahan.

AWSTemplateFormatVersion: '2010-09-09'
Resources:
  HighErrorCountAlarm:
    Type: AWS::CloudWatch::LogAlarm
    Properties:
      AlarmName: HighErrorCount
      AlarmDescription: Alarm when error count exceeds 100
      ComparisonOperator: GreaterThanThreshold
      Threshold: 100
      QueryResultsToEvaluate: 5
      QueryResultsToAlarm: 3
      TreatMissingData: missing
      ActionLogLineCount: 5
      ActionLogLineRoleArn: !GetAtt LogLineRole.Arn
      ScheduledQueryConfiguration:
        QueryString: "fields @timestamp, @message | filter @message like /ERROR/"
        LogGroupIdentifiers:
          - /aws/lambda/my-function
        ScheduledQueryRoleARN: !GetAtt ScheduledQueryRole.Arn
        AggregationExpression: "count(*)"
        ScheduleConfiguration:
          ScheduleExpression: "rate(10 minutes)"
          StartTimeOffset: 600
      AlarmActions:
        - !Ref AlarmSNSTopic

Buat CloudWatch alarm berdasarkan filter metrik grup log

Prosedur yang diuraikan pada bagian ini akan menjelaskan cara membuat alarm berdasarkan filter metrik grup log. Dengan filter metrik, Anda dapat mencari istilah dan pola dalam data log saat data dikirim CloudWatch. Untuk informasi selengkapnya, lihat Membuat metrik dari peristiwa log menggunakan filter di Panduan Pengguna CloudWatch Log Amazon. Sebelum Anda membuat sebuah alarm berdasarkan filter metrik grup log, Anda harus terlebih dahulu menyelesaikan tindakan-tindakan berikut: