aws_cloudwatchagent

Ansible Роль: AWS CloudWatch Agent

Эта Ansible роль устанавливает и настраивает AWS CloudWatch Agent на экземплярах AWS EC2 и локальных серверах.

Требования

  • AWS EC2 экземпляр или локальный Linux сервер
  • Если используется экземпляр AWS EC2, он должен иметь прикрепленную IAM роль с политиками для запуска AWS CloudWatch Agent. Рекомендуется использовать предоставленную AWS политику — CloudWatchAgentServerPolicy.
  • Если используется локальный сервер, настройте /root/.aws/credentials и /root/.aws/config.
  • Укажите YAML переменную aws_cloudwatch_agent_config. Она будет преобразована в JSON. Для базовой конфигурации смотрите defaults/main.yml.

Переменные Роли

Переменная Значение по умолчанию Описание Обязательно?
aws_cloudwatch_agent_username Административный пользователь, который должен быть владельцем загруженных файлов. Обычно совпадает с remote_user. На Ubuntu это может быть ubuntu, на CentOS — centos, а на Amazon Linux — ec2-user. Роль определяет имя пользователя в зависимости от ОС, если оно не указано явно. Нет
aws_cloudwatch_agent_download_directory Место, куда должно быть загружено программное обеспечение AWS CloudWatch Agent. Роль определяет расположение в зависимости от ОС, если оно не указано явно. Нет
aws_cloudwatch_agent_download_url URL, с которого должен быть загружен Amazon CloudWatchAgent. Это автоматически устанавливается ролью. Но вы можете изменить его. Нет
aws_cloudwatch_agent_mode ec2 Режим AWS CloudWatch Agent. Может быть одним из ec2, onPremise и auto Нет

Пример файла JSON: aws-cw-config.json

agent:
    metrics_collection_interval: 60
    run_as_user: "cwagent"
metrics:
    namespace: "Gavika"
    append_dimensions:
      InstanceId: "${aws:InstanceId}"
    metrics_collected:
      disk:
        measurement:
          - used_percent
        metrics_collection_interval: 60
        resources:
          - "*"
      mem:
        measurement:
          - mem_used_percent
        metrics_collection_interval: 60

Пример /root/.aws/credentials для локального сервера:

[AmazonCloudWatchAgent]
aws_access_key_id = youaccesskeyid
aws_secret_access_key = yoursecretkey

Пример /root/.aws/config для локального сервера:

[AmazonCloudWatchAgent]
region = us-east-1

Для списка метрик смотрите документацию AWS CloudWatchAgent

Пример Playbook

    - hosts: cloudwatch-servers
      roles:
         - role: Gavika.aws-cloudwatch-agent

Непрерывная Интеграция

Вы можете запускать тесты Molecule локально.

Лицензия

Apache2

Информация об Авторе

Судхир Сатьянарайана

Gavika

О проекте

Install and configure AWS CloudWatch Agent

Установить
ansible-galaxy install gavika/aws-cloudwatchagent
Лицензия
Unknown
Загрузки
247