View a markdown version of this page

Membuat dan mengonfigurasi pemantauan Appl CloudWatch ication Insights menggunakan CloudFormation template - Amazon CloudWatch
Buat aplikasi Application Insights untuk keseluruhan CloudFormation tumpukanMembuat sebuah aplikasi Wawasan Aplikasi dengan pengaturan terperinciMembuat aplikasi Application Insights dengan konfigurasi komponen mode KUSTOMBuat aplikasi Application Insights dengan konfigurasi komponen mode DEFAULTBuat aplikasi Application Insights dengan konfigurasi komponen mode DEFAULT_WITH_OVERWRITE

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

Membuat dan mengonfigurasi pemantauan Appl CloudWatch ication Insights menggunakan CloudFormation template

Anda dapat menambahkan pemantauan Application Insights, termasuk metrik utama dan telemetri, ke aplikasi, database, dan server web Anda, langsung dari AWS CloudFormation template.

Bagian ini menyediakan CloudFormation template sampel dalam format JSON dan YAML untuk membantu Anda membuat dan mengonfigurasi pemantauan Application Insights.

Untuk melihat referensi sumber daya dan properti Application Insights di Panduan CloudFormation Pengguna, lihat referensi jenis ApplicationInsights sumber daya.

Buat aplikasi Application Insights untuk keseluruhan CloudFormation tumpukan

Untuk menerapkan template berikut, Anda harus membuat AWS sumber daya dan satu atau beberapa grup sumber daya untuk membuat aplikasi Application Insights untuk memantau sumber daya tersebut. Untuk informasi selengkapnya, silakan lihat Memulai dengan Grup Sumber Daya AWS.

Dua bagian pertama dari template berikut menentukan sebuah sumber daya dan sebuah grup sumber daya. Bagian terakhir dari template tersebut membuat sebuah aplikasi Wawasan Aplikasi untuk grup sumber daya, tetapi tidak mengonfigurasi aplikasi atau menerapkan pemantauan. Untuk informasi selengkapnya, lihat detail CreateApplication perintah di Referensi API Amazon Appl CloudWatch ication Insights.

Template dalam format JSON

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Test Resource Group stack",
    "Resources": {
        "EC2Instance": {
            "Type": "AWS::EC2::Instance",
            "Properties": {
                "ImageId" : "ami-abcd1234efgh5678i",
                "SecurityGroupIds" : ["sg-abcd1234"]
            }
        },
        ...
        "ResourceGroup": {
            "Type": "AWS::ResourceGroups::Group",
            "Properties": {
                "Name": "my_resource_group"
            }
        },
        "AppInsightsApp": {
            "Type": "AWS::ApplicationInsights::Application",
            "Properties": {
                "ResourceGroupName": "my_resource_group"
            },
            "DependsOn" : "ResourceGroup"
        }
    }
}

Template dalam format YAML

---
AWSTemplateFormatVersion: '2010-09-09'
Description: Test Resource Group stack
Resources:
  EC2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: ami-abcd1234efgh5678i
      SecurityGroupIds:
      - sg-abcd1234
  ...
  ResourceGroup:
    Type: AWS::ResourceGroups::Group
    Properties:
      Name: my_resource_group
  AppInsightsApp:
    Type: AWS::ApplicationInsights::Application
    Properties:
      ResourceGroupName: my_resource_group
    DependsOn: ResourceGroup

Bagian template berikut menerapkan konfigurasi pemantauan bawaan ke aplikasi Wawasan Aplikasi. Untuk informasi selengkapnya, lihat detail CreateApplication perintah di Referensi API Amazon Appl CloudWatch ication Insights.

Saat AutoConfigurationEnabled diatur menjadi true, semua komponen aplikasi dikonfigurasi dengan pengaturan pemantauan yang disarankan untuk tingkat aplikasi DEFAULT. Untuk informasi selengkapnya tentang pengaturan dan tingkatan ini, lihat DescribeComponentConfigurationRecommendation dan UpdateComponentConfiguration di Referensi API Wawasan CloudWatch Aplikasi Amazon.

Template dalam format JSON

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "Test Application Insights Application stack",
    "Resources": {
        "AppInsightsApp": {
            "Type": "AWS::ApplicationInsights::Application",
            "Properties": {
                "ResourceGroupName": "my_resource_group",
                "AutoConfigurationEnabled": true
            }
        }
    }
}

Template dalam format YAML

---
AWSTemplateFormatVersion: '2010-09-09'
Description: Test Application Insights Application stack
Resources:
  AppInsightsApp:
    Type: AWS::ApplicationInsights::Application
    Properties:
      ResourceGroupName: my_resource_group
      AutoConfigurationEnabled: true

Membuat sebuah aplikasi Wawasan Aplikasi dengan pengaturan terperinci

Template berikut melakukan tindakan ini:

  • Membuat aplikasi Application Insights dengan pemberitahuan CloudWatch Acara dan OpsCenter diaktifkan. Untuk informasi selengkapnya, lihat detail CreateApplication perintah di Referensi API Amazon Appl CloudWatch ication Insights.

  • Menandai aplikasi dengan dua tag, salah satu tanda tidak memiliki nilai tag. Untuk informasi selengkapnya, lihat TagResource Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Membuat dua komponen grup instans kustom. Untuk informasi selengkapnya, lihat CreateComponent Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Membuat dua set pola log. Untuk informasi selengkapnya, lihat CreateLogPattern Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Atur AutoConfigurationEnabled menjadi true, yang akan mengonfigurasi semua komponen aplikasi dengan pengaturan pemantauan yang disarankan untuk tingkat DEFAULT. Untuk informasi selengkapnya, lihat DescribeComponentConfigurationRecommendation Referensi API Wawasan CloudWatch Aplikasi Amazon.

Template dalam format JSON 

{
    "Type": "AWS::ApplicationInsights::Application",
    "Properties": {
        "ResourceGroupName": "my_resource_group",
        "CWEMonitorEnabled": true,
        "OpsCenterEnabled": true,
        "OpsItemSNSTopicArn": "arn:aws:sns:us-east-1:123456789012:my_topic",
        "AutoConfigurationEnabled": true,
        "Tags": [
            {
                "Key": "key1",
                "Value": "value1"
            },
            {
                "Key": "key2",
                "Value": ""
            }
        ],
        "CustomComponents": [
            {
                "ComponentName": "test_component_1",
                "ResourceList": [
                    "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i"
                ]
            },
            {
                "ComponentName": "test_component_2",
                "ResourceList": [
                    "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i",
                    "arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i"
                ]
            }
        ],
        "LogPatternSets": [
            {
                "PatternSetName": "pattern_set_1",
                "LogPatterns": [
                    {
                        "PatternName": "deadlock_pattern",
                        "Pattern": ".*\\sDeadlocked\\sSchedulers(([^\\w].*)|($))",
                        "Rank": 1
                    }
                ]    
            },
            {
                "PatternSetName": "pattern_set_2",
                "LogPatterns": [
                    {
                        "PatternName": "error_pattern",
                        "Pattern": ".*[\\s\\[]ERROR[\\s\\]].*",
                        "Rank": 1
                    },
                    {
                        "PatternName": "warning_pattern",
                        "Pattern": ".*[\\s\\[]WARN(ING)?[\\s\\]].*",
                        "Rank": 10
                    }
                ]
            }
        ]
    }
}

Template dalam format YAML

---
Type: AWS::ApplicationInsights::Application
Properties:
  ResourceGroupName: my_resource_group
  CWEMonitorEnabled: true
  OpsCenterEnabled: true
  OpsItemSNSTopicArn: arn:aws:sns:us-east-1:123456789012:my_topic
  AutoConfigurationEnabled: true
  Tags:
  - Key: key1
    Value: value1
  - Key: key2
    Value: ''
  CustomComponents:
  - ComponentName: test_component_1
    ResourceList:
    - arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i
  - ComponentName: test_component_2
    ResourceList:
    - arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i
    - arn:aws:ec2:us-east-1:123456789012:instance/i-abcd1234efgh5678i
  LogPatternSets:
  - PatternSetName: pattern_set_1
    LogPatterns:
    - PatternName: deadlock_pattern
      Pattern: ".*\\sDeadlocked\\sSchedulers(([^\\w].*)|($))"
      Rank: 1
  - PatternSetName: pattern_set_2
    LogPatterns:
    - PatternName: error_pattern
      Pattern: ".*[\\s\\[]ERROR[\\s\\]].*"
      Rank: 1
    - PatternName: warning_pattern
      Pattern: ".*[\\s\\[]WARN(ING)?[\\s\\]].*"
      Rank: 10

Membuat aplikasi Application Insights dengan konfigurasi komponen mode KUSTOM

Template berikut akan melakukan tindakan-tindakan ini:

  • Membuat sebuah aplikasi Wawasan Aplikasi. Untuk informasi selengkapnya, lihat CreateApplication Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Komponen my_component diatur ComponentConfigurationMode ke CUSTOM, yang akan menyebabkan komponen ini dikonfigurasi dengan konfigurasi yang ditentukan dalam CustomComponentConfiguration. Untuk informasi selengkapnya, lihat UpdateComponentConfiguration Referensi API Wawasan CloudWatch Aplikasi Amazon.

Template dalam format JSON

{
    "Type": "AWS::ApplicationInsights::Application",
    "Properties": {
        "ResourceGroupName": "my_resource_group,
        "ComponentMonitoringSettings": [
            {
                "ComponentARN": "my_component",
                "Tier": "SQL_SERVER",
                "ComponentConfigurationMode": "CUSTOM",
                "CustomComponentConfiguration": {
                    "ConfigurationDetails": {
                        "AlarmMetrics": [
                            {
                                "AlarmMetricName": "StatusCheckFailed"
                            },
                            ...
                        ],
                        "Logs": [
                            {       
                                "LogGroupName": "my_log_group_1",
                                "LogPath": "C:\\LogFolder_1\\*",
                                "LogType": "DOT_NET_CORE",
                                "Encoding": "utf-8",
                                "PatternSet": "my_pattern_set_1"
                            },      
                            ...     
                        ],      
                        "WindowsEvents": [
                            {       
                                "LogGroupName": "my_windows_event_log_group_1",
                                "EventName": "Application",
                                "EventLevels": [
                                    "ERROR",
                                    "WARNING",
                                    ...     
                                ],       
                                "Encoding": "utf-8",
                                "PatternSet": "my_pattern_set_2"
                            },      
                            ...     
                        ],
                        "Alarms": [
                            {
                                "AlarmName": "my_alarm_name",
                                "Severity": "HIGH"
                            },
                            ...
                        ]
                    },
                    "SubComponentTypeConfigurations": [
                        {
                            "SubComponentType": "EC2_INSTANCE",
                            "SubComponentConfigurationDetails": {
                                "AlarmMetrics": [
                                    {
                                        "AlarmMetricName": "DiskReadOps"
                                    },
                                    ...
                                ],
                                "Logs": [
                                    {
                                        "LogGroupName": "my_log_group_2",
                                        "LogPath": "C:\\LogFolder_2\\*",
                                        "LogType": "IIS",
                                        "Encoding": "utf-8",
                                        "PatternSet": "my_pattern_set_3"
                                    },
                                    ...
                                ],
                                "processes" : [
                                    {
                                        "processName" : "my_process",
                                        "alarmMetrics" : [
                                    {
                                        "alarmMetricName" : "procstat cpu_usage",
                                        "monitor" : true
                                    }, {
                                        "alarmMetricName" : "procstat memory_rss",
                                        "monitor" : true
                                    }
                                ]
                            }
                        ],
                                "WindowsEvents": [
                                    {
                                        "LogGroupName": "my_windows_event_log_group_2",
                                        "EventName": "Application",
                                        "EventLevels": [
                                            "ERROR",
                                            "WARNING",
                                            ...
                                        ],
                                        "Encoding": "utf-8",
                                        "PatternSet": "my_pattern_set_4"
                                    },
                                    ...
                                ]
                            }
                        }   
                    ]
                }
            }
        ]
    }
}

Template dalam format YAML

---
Type: AWS::ApplicationInsights::Application
Properties:
  ResourceGroupName: my_resource_group
  ComponentMonitoringSettings:
  - ComponentARN: my_component
    Tier: SQL_SERVER
    ComponentConfigurationMode: CUSTOM
    CustomComponentConfiguration:
      ConfigurationDetails:
        AlarmMetrics:
        - AlarmMetricName: StatusCheckFailed
        ...
        Logs:
        - LogGroupName: my_log_group_1
          LogPath: C:\LogFolder_1\*
          LogType: DOT_NET_CORE
          Encoding: utf-8
          PatternSet: my_pattern_set_1
        ...
        WindowsEvents:
        - LogGroupName: my_windows_event_log_group_1
          EventName: Application
          EventLevels:
          - ERROR
          - WARNING
          ...
          Encoding: utf-8
          PatternSet: my_pattern_set_2
        ...
        Alarms:
        - AlarmName: my_alarm_name
          Severity: HIGH
        ...
      SubComponentTypeConfigurations:
      - SubComponentType: EC2_INSTANCE
        SubComponentConfigurationDetails:
          AlarmMetrics:
          - AlarmMetricName: DiskReadOps
          ...
          Logs:
          - LogGroupName: my_log_group_2
            LogPath: C:\LogFolder_2\*
            LogType: IIS
            Encoding: utf-8
            PatternSet: my_pattern_set_3
          ...
          Processes:
          - ProcessName: my_process
            AlarmMetrics:
            - AlarmMetricName: procstat cpu_usage
              ...
            ...
          WindowsEvents:
          - LogGroupName: my_windows_event_log_group_2
            EventName: Application
            EventLevels:
            - ERROR
            - WARNING
            ...
            Encoding: utf-8
            PatternSet: my_pattern_set_4
          ...

Buat aplikasi Application Insights dengan konfigurasi komponen mode DEFAULT

Template berikut akan melakukan tindakan-tindakan ini:

  • Membuat sebuah aplikasi Wawasan Aplikasi. Untuk informasi selengkapnya, lihat CreateApplication Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Komponen my_component mengatur ComponentConfigurationMode dengan DEFAULT dan Tier dengan SQL_SERVER, yang akan menyebabkan komponen ini dikonfigurasi dengan pengaturan konfigurasi yang direkomendasikan oleh Wawasan Aplikasi untuk tingkat SQL_Server. Untuk informasi selengkapnya, lihat DescribeComponentConfiguration dan UpdateComponentConfiguration di Referensi API Wawasan CloudWatch Aplikasi Amazon.

Template dalam format JSON

{
    "Type": "AWS::ApplicationInsights::Application",
    "Properties": {
        "ResourceGroupName": "my_resource_group",
        "ComponentMonitoringSettings": [
            {
                "ComponentARN": "my_component",
                "Tier": "SQL_SERVER",
                "ComponentConfigurationMode": "DEFAULT"
            }
        ]
    }
}

Template dalam format YAML

---
Type: AWS::ApplicationInsights::Application
Properties:
  ResourceGroupName: my_resource_group
  ComponentMonitoringSettings:
  - ComponentARN: my_component
    Tier: SQL_SERVER
    ComponentConfigurationMode: DEFAULT

Buat aplikasi Application Insights dengan konfigurasi komponen mode DEFAULT_WITH_OVERWRITE

Template berikut akan melakukan tindakan-tindakan ini:

  • Membuat sebuah aplikasi Wawasan Aplikasi. Untuk informasi selengkapnya, lihat CreateApplication Referensi API Wawasan CloudWatch Aplikasi Amazon.

  • Komponen my_component mengatur ComponentConfigurationMode dengan DEFAULT_WITH_OVERWRITE dan tier dengan DOT_NET_CORE, yang akan menyebabkan komponen ini dikonfigurasi dengan pengaturan konfigurasi yang direkomendasikan oleh Wawasan Aplikasi untuk tingkat DOT_NET_CORE. Pengaturan konfigurasi yang ditimpa ditentukan di DefaultOverwriteComponentConfiguration:

    • Pada tingkat komponen, pengaturan AlarmMetrics ditimpa.

    • Pada tingkat sub-komponen, untuk sub-komponen jenis EC2_Instance, pengaturan Logs ditimpa.

    Untuk informasi selengkapnya, lihat UpdateComponentConfiguration Referensi API Wawasan CloudWatch Aplikasi Amazon.

Template dalam format JSON

{
    "Type": "AWS::ApplicationInsights::Application",
    "Properties": {
        "ResourceGroupName": "my_resource_group",
        "ComponentMonitoringSettings": [
            {
                "ComponentName": "my_component",
                "Tier": "DOT_NET_CORE",
                "ComponentConfigurationMode": "DEFAULT_WITH_OVERWRITE",
                "DefaultOverwriteComponentConfiguration": {
                    "ConfigurationDetails": {
                        "AlarmMetrics": [
                            {
                                "AlarmMetricName": "StatusCheckFailed"
                            }
                        ]
                    },
                    "SubComponentTypeConfigurations": [
                        {
                            "SubComponentType": "EC2_INSTANCE",
                            "SubComponentConfigurationDetails": {
                                "Logs": [
                                    {
                                        "LogGroupName": "my_log_group",
                                        "LogPath": "C:\\LogFolder\\*",
                                        "LogType": "IIS",
                                        "Encoding": "utf-8",
                                        "PatternSet": "my_pattern_set"
                                    }
                                ]
                            }
                        }   
                    ] 
                } 
            }
        ]
    }
}

Template dalam format YAML

---
Type: AWS::ApplicationInsights::Application
Properties:
  ResourceGroupName: my_resource_group
  ComponentMonitoringSettings:
  - ComponentName: my_component
    Tier: DOT_NET_CORE
    ComponentConfigurationMode: DEFAULT_WITH_OVERWRITE
    DefaultOverwriteComponentConfiguration:
      ConfigurationDetails:
        AlarmMetrics:
        - AlarmMetricName: StatusCheckFailed
      SubComponentTypeConfigurations:
      - SubComponentType: EC2_INSTANCE
        SubComponentConfigurationDetails:
          Logs:
          - LogGroupName: my_log_group
            LogPath: C:\LogFolder\*
            LogType: IIS
            Encoding: utf-8
            PatternSet: my_pattern_set