librato.librato
Ansible Role: Librato
Libratoエージェントとプラグインをインストールおよび設定するAnsibleロールです。
要件
なし
依存関係
なし
クイックスタート
始めるために必要なのは、email
とtoken
の変数を設定し、ロールを含めることです:
- hosts: all
roles:
- { role: librato.librato, librato_email: 'あなたのメール@ドメイン.com', librato_token: 'あなたのトークン' }
デフォルトでは、以下のプラグインが有効になっています:cpu
、df
、disk
、swap
、memory
、load
。
プラグインを追加するには、必要な変数を設定し、その後librato_enabled_plugins
変数に追加します:
- hosts: all
vars:
librato_apache_path: '/my-status-endpoint'
librato_enabled_plugins: ['apache']
サポートされているプラグイン
cpu
df
memory
load
disk
swap
apache
nginx
nginx_plus
jvm
memcached
varnish
zookeeper
docker
elasticsearch
mongodb
postgresql
mysql
redis
haproxy
使用方法
カスタムまたはアップストリームcollectdプラグインを使用する
独自のカスタムまたはアップストリームcollectdプラグインを使用するには、別のモジュールから設定を/opt/collectd/etc/collectd.conf.d/
にドロップし、カスタムプラグインを/opt/collectd/share/collectd/
に配置してください。
参考
プラグイン:apache
librato_apache_protocol
タイプ:文字列 使用するプロトコル。デフォルトはhttp
。SSLが必要な場合はhttps
に変更します。librato_apache_host
タイプ:文字列 使用するホスト名。デフォルトはlocalhost
。librato_apache.path
タイプ:文字列 ステータスページへのパス。デフォルトは/server-status
。?auto
は自動的に追加されるため、含める必要はありません。librato_apache_user
タイプ:文字列 パスワード保護されたステータスページで使用するユーザー名。デフォルトは空です。librato_apache_password
タイプ:文字列 パスワード保護されたステータスページで使用するパスワード。デフォルトは空です。
(他のプラグインについても同様に続けますが、長いため省略しました。)
グローバル変数
librato_email
タイプ:文字列 メトリクス送信に使用するメールアドレス。token
とともに使用します。この属性は必須で、デフォルトは空です。librato_token
タイプ:文字列 メトリクス送信に使用するAPIトークン。email
とともに使用します。この属性は必須で、デフォルトは空です。
(他の変数についても同様に続けますが、長いため省略しました。)
サポートされているプラットフォーム
- RHEL 6 / CentOS 6
- RHEL 7 / CentOS 7
- Fedora 23
- Amazon Linux 2016.03
- Ubuntu 12.04
- Ubuntu 14.04
- Ubuntu 15.04
- Ubuntu 15.10
- Ubuntu 16.04
- Debian 7
- Debian 8
サポートされているAnsibleバージョン
このロールはAnsible 2.2以上を必要とします。
開発
テスト
統合テストにはkitchen-ansible
とserverspec
を利用します。テストスイートを実行するには:
bundle install
を実行kitchen test
を実行
(他のテスト方法についても同様に続けますが、長いため省略しました。)
ライセンス
MIT
作者・貢献者
マイク・ジュリアン (@mjulian)