Ansibleロール: AWSLogsEC2

このロールは、AWS CloudWatch Logsエージェントをインストールおよび設定します。

必要条件

このロールは、Ansibleバージョン2.4以上とEC2_FACTSモジュールが必要です。

ロール変数

awslogs_logs:
  - file:  /var/log/messages          # 送信したいログファイルのパス（必須）
    format: "%b %d %H:%M:%S"          # ログファイルの日付と時刻の形式
    time_zone: "LOCAL"                # タイムゾーン、LOCALまたはUTC
    initial_position: "start_of_file" # ログ送信を開始する位置
    group_name: /var/log/messages     # CloudWatch Logsグループ名（必須）
    stream_name: "{instance_id}"      # リテラル文字列やプリ定義された変数（{instance_id}、{hostname}、{ip_address}）を使用可能

さらに、デフォルトでは使用されない変数が3つあります：

awslogs_region: eu-west-1            # ログ送信のためのローカルリージョンを上書き

インスタンスがHTTPまたはHTTPプロキシの背後にある場合、以下の変数で設定できます：

awslogs_enable_proxy: true
awslogs_http_proxy: http://your.proxy:80/
awslogs_https_proxy: http://your.https.proxy:80/
awslogs_noproxy: 169.254.169.254

この設定については、Amazon CloudWatch Logsのドキュメントにさらに詳しく説明されています。

依存関係

なし

例題プレイブック

---

- hosts: all

  vars:
    awslogs_region: eu-west-1
    awslogs_logs:
    - file: /var/log/messages
      format: "%b %d %H:%M:%S"
      time_zone: "LOCAL"
      initial_position: "start_of_file"
      group_name: /var/log/messages
      stream_name: "{instance_id}"

  roles:
    - naoyayamamoto.awslogs_ec2

ライセンス

MIT / BSD