Buat file konfigurasi CloudWatch agen

Sebelum menjalankan CloudWatch agen di server apa pun, Anda harus membuat satu atau lebih file konfigurasi CloudWatch agen.

File konfigurasi agen adalah file JSON yang menentukan metrik, log, dan jejak yang akan dikumpulkan agen, termasuk metrik kustom. Anda dapat membuatnya dengan menggunakan pemandu atau dengan membuatnya sendiri dari awal. Anda juga dapat menggunakan pemandu untuk membuat file konfigurasi di awal lalu mengubahnya secara manual. Jika membuat atau memodifikasi file secara manual, prosesnya lebih rumit, tetapi Anda memiliki kontrol lebih banyak atas metrik yang dikumpulkan dan dapat menentukan metrik yang tidak tersedia melalui pemandu.

Setiap kali mengubah file konfigurasi agen, Anda kemudian harus memulai ulang agen agar perubahan berlaku. Untuk memulai ulang agen, ikuti petunjuk di (Opsional) Ubah konfigurasi umum dan profil bernama untuk CloudWatch agen.

Setelah membuat file konfigurasi, Anda dapat menyimpannya secara manual sebagai file JSON lalu menggunakan file ini saat melakukan instalasi agen di server Anda. Atau, Anda dapat menyimpannya di System Manager Parameter Store jika Anda akan menggunakan System Manager saat melakukan instalasi agen di server.

CloudWatch Agen mendukung penggunaan beberapa file konfigurasi. Untuk informasi selengkapnya, lihat Membuat beberapa file konfigurasi CloudWatch agen.

Metrik, log, dan jejak yang dikumpulkan oleh CloudWatch agen menimbulkan biaya. Untuk informasi selengkapnya tentang harga, lihat CloudWatchHarga Amazon.

Daftar Isi

• Buat file konfigurasi CloudWatch agen dengan wizard

• Membuat beberapa file konfigurasi CloudWatch agen

• Buat atau edit file konfigurasi CloudWatch agen secara manual

Membuat beberapa file konfigurasi CloudWatch agen

Di server Linux dan server Windows, Anda dapat mengatur CloudWatch agen untuk menggunakan beberapa file konfigurasi. Sebagai contoh, Anda dapat menggunakan file konfigurasi umum yang mengumpulkan serangkaian metrik, log, dan jejak yang selalu ingin Anda kumpulkan dari semua server di infrastruktur Anda. Kemudian Anda dapat menggunakan file konfigurasi tambahan yang mengumpulkan metrik dari aplikasi tertentu atau dalam situasi tertentu.

Untuk mengatur ini, pertama-tama buat file konfigurasi yang ingin Anda gunakan. Setiap file konfigurasi yang akan digunakan bersama di server yang sama harus memiliki nama file yang berbeda. Anda dapat menyimpan file konfigurasi di server atau di Parameter Store.

Mulai CloudWatch agen menggunakan fetch-config opsi dan tentukan file konfigurasi pertama. Untuk menambahkan file konfigurasi kedua ke agen yang berjalan, gunakan perintah yang sama tetapi dengan append-config pilihan yang tepat. Semua metrik, log, dan jejak yang tercantum di salah satu file konfigurasi dikumpulkan. Contoh perintah berikut menggambarkan skenario ini menggunakan konfigurasi disimpan sebagai file. Baris pertama memulai agen dengan menggunakan file konfigurasi infrastructure.json, dan baris kedua menambahkan file konfigurasi app.json.

Contoh perintah berikut adalah untuk Linux.

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:/tmp/infrastructure.json

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -m ec2 -s -c file:/tmp/app.json

Contoh perintah berikut adalah untuk Windows Server.

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -s -c file:"C:\Program Files\Amazon\AmazonCloudWatchAgent\infrastructure.json"

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a append-config -m ec2 -s -c file:"C:\Program Files\Amazon\AmazonCloudWatchAgent\app.json"

Contoh file konfigurasi berikut menggambarkan penggunaan untuk fitur ini. File konfigurasi pertama digunakan untuk semua server dalam infrastruktur, dan yang kedua hanya mengumpulkan log dari aplikasi tertentu dan ditambahkan untuk server yang menjalankan aplikasi tersebut.

infrastructure.json

{
  "metrics": {
    "metrics_collected": {
      "cpu": {
        "resources": [
          "*"
        ],
        "measurement": [
          "usage_active"
        ],
        "totalcpu": true
      },
      "mem": {
         "measurement": [
           "used_percent"
        ]
      }
    }
  },
  "logs": {
    "logs_collected": {
      "files": {
        "collect_list": [
          {
            "file_path": "/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log",
            "log_group_name": "amazon-cloudwatch-agent.log"
          },
          {
            "file_path": "/var/log/messages",
            "log_group_name": "/var/log/messages"
          }
        ]
      }
    }
  }
}

app.json

{
    "logs": {
        "logs_collected": {
            "files": {
                "collect_list": [
                    {
                        "file_path": "/app/app.log*",
                        "log_group_name": "/app/app.log"
                    }
                ]
            }
        }
    }
}

Setiap file konfigurasi yang ditambahkan ke konfigurasi harus memiliki nama file yang berbeda satu sama lain dan dari file konfigurasi awal. Jika Anda menggunakan append-config dengan file konfigurasi dengan nama file yang sama sebagai file konfigurasi yang sudah digunakan agen, perintah penambahan menimpa informasi dari file konfigurasi pertama, bukan menambahkannya. Hal ini berlaku bahkan jika dua file konfigurasi dengan nama file yang sama berada di jalur file yang berbeda.

Contoh sebelumnya menunjukkan penggunaan dua file konfigurasi, tetapi tidak ada batas jumlah file konfigurasi yang dapat Anda tambahkan ke konfigurasi agen. Anda juga dapat menggabungkan penggunaan file konfigurasi yang terletak di server dan konfigurasi yang berada di Parameter Store.