Dell-Networking.dellos-logging
ログ設定役割
この役割は、グローバルログ属性の設定を支援し、ログサーバーの設定をサポートします。この役割は、dellos6、dellos9、およびdellos10に抽象化されています。
ログ設定役割は、Dell EMCネットワークデバイスへの接続にSSH接続が必要です。いずれかの組み込みOS接続変数を使用できます。
インストール
ansible-galaxy install Dell-Networking.dellos-logging
役割変数
- 役割は、ansible_network_os変数を使用して抽象化されており、dellos9、dellos6、およびdellos10の値を取ります。
- dellos_cfg_generate変数がtrueに設定されている場合、役割の設定コマンドがファイルに生成されます。
- それに対応するstate変数がabsentに設定された場合、その変数の設定は無効になります。
- 変数の空の値を設定すると、対応する設定は無効になります。
- 変数と値は大文字と小文字を区別します。
dellos_loggingキー
キー | 種類 | 説明 | サポート |
---|---|---|---|
logging |
リスト | ログサーバーを設定します (logging.* を参照) |
dellos6, dellos9, dellos10 |
logging.ip |
文字列 (必須) | ログサーバーのIPv4アドレスを設定します (A.B.C.D形式) | dellos6, dellos9, dellos10 |
logging.secure_port |
整数 | TLSポートを介してログメッセージを指定します | dellos9 |
logging.tcp_port |
整数 | secure_portが定義されていない場合にTCPポートを介してログメッセージを指定します | dellos9 |
logging.udp_port |
整数 | TCPとsecure_portがどちらも定義されていない場合にUDPポートを介してログメッセージを指定します | dellos9 |
logging.vrf |
辞書 | ホストに到達するために使用するVRFインスタンスを指定します | dellos9 |
logging.vrf.name |
文字列 | VRF名を指定します | dellos9 |
logging.vrf.secure_port |
整数 | TLSポートを介してログメッセージを指定します | dellos9 |
logging.vrf.tcp_port |
整数 | secure_portが定義されていない場合にTCPポートを介してログメッセージを指定します | dellos9 |
logging.vrf.udp_port |
整数 | TCPとsecure_portがどちらも定義されていない場合にUDPポートを介してログメッセージを指定します | dellos9 |
logging.vrf.state |
文字列: absent,present* | absentに設定された場合、ログサーバーのVRFインスタンスを削除します | dellos9 |
logging.state |
文字列: absent,present* | absentに設定された場合、ログサーバーを削除します | dellos6, dellos9, dellos10 |
console |
辞書 | コンソールへのログ設定を行います (console.* を参照) |
dellos10 |
console.enable |
ブール値 | コンソールへのログを有効/無効にします | dellos10 |
console.severity |
文字列 | コンソールへのログの最小重大度レベルを設定します | dellos10 |
log_file |
辞書 | ログファイルへのログ設定を行います (log_file.* を参照) |
dellos10 |
log_file.enable |
ブール値 | ログファイルへのログを有効/無効にします | dellos10 |
log_file.severity |
文字列 | ログファイルへのログの最小重大度レベルを設定します | dellos10 |
buffer |
整数 | バッファされたログの重大度レベルを指定します (0から7) | dellos9 |
console_level |
整数 | コンソールのログレベルを設定します (0から7) | dellos9 |
trap_level |
整数 | syslogサーバーの重大度レベルを設定します (0から7) | dellos9 |
syslog_version |
整数 | syslogのバージョンを設定します (0/1) | dellos9 |
monitor |
整数 | ターミナルラインのログレベルを設定します (0から7) | dellos9 |
history |
整数 | syslogの履歴テーブルを設定します (0から7) | dellos9 |
history_size |
整数 | 履歴テーブルのサイズを指定します | dellos9 |
on |
ブール値 | trueに設定すると、すべてのサポートされている宛先へのログを有効にします | dellos9 |
extended |
ブール値 | trueに設定すると拡張ログを有効にします | dellos9 |
coredump |
辞書 | coredumpのログ設定を行います | dellos9 |
coredump.server |
辞書 | すべてのサーバーの詳細を指定します | dellos9 |
coredump.server.server_ip |
文字列 (必須) | ログサーバーのIPv4/IPv6アドレスを指定します | dellos9 |
coredump.server.username |
文字列 | 設定するユーザー名を指定します | dellos9 |
coredump.server.password |
文字列 | 設定するパスワードを指定します | dellos9 |
coredump.server.state |
文字列: present,absent* | absentに設定された場合、coredumpサーバーを削除します | dellos9 |
coredump.stackunit |
辞書 | スタックユニットでcoredumpを有効にするための詳細を指定します | dellos9 |
coredump.stackunit.all |
ブール値 | すべてのスタックユニットでcoredumpを有効にします | dellos9 |
coredump.stackunit.unit_num |
整数 | スタックユニット番号を指定します (0から5) | dellos9 |
coredump.stackunit.state |
文字列: present,absent* | absentに設定された場合、スタックユニットのcoredumpを削除します | dellos9 |
source_interface |
文字列 | ログのソースインターフェースを設定します | dellos6, dellos9, dellos10 |
注意: アスタリスク (*) は、指定がない場合のデフォルト値を示します。
接続変数
Ansible Dell EMC Networkingロールは、インベントリ内のノードと通信するために接続情報を必要とします。この情報は、Ansibleのgroup_varsまたはhost_varsディレクトリ、インベントリ、またはプレイブック自体に存在することがあります。
キー | 必須 | 選択肢 | 説明 |
---|---|---|---|
ansible_host |
はい | 指定されたトランスポートを介してリモートデバイスに接続するためのホスト名またはアドレスを指定します | |
ansible_port |
いいえ | リモートデバイスに接続するために使用されるポートを指定します; 値が指定されていない場合、ANSIBLE_REMOTE_PORTオプションが使用され、デフォルトは22です | |
ansible_ssh_user |
いいえ | リモートデバイスへの接続のCLIログインを認証するためのユーザー名を指定します; 値が指定されていない場合、ANSIBLE_REMOTE_USER環境変数の値が使用されます | |
ansible_ssh_pass |
いいえ | リモートデバイスへの接続を認証するためのパスワードを指定します | |
ansible_become |
いいえ | はい, いいえ* | リモートデバイスでコマンドを送信する前に特権モードに入るようにモジュールに指示します; 値が指定されていない場合、ANSIBLE_BECOME環境変数の値が使用され、デバイスはすべてのコマンドを非特権モードで実行しようとします |
ansible_become_method |
いいえ | enable, sudo* | 特権昇格を処理するためのbecomeメソッドを指定できるようにモジュールに指示します; 値が指定されていない場合、ANSIBLE_BECOME_METHOD環境変数の値が使用されます |
ansible_become_pass |
いいえ | リモートデバイスで特権モードに入る必要がある場合に使用するパスワードを指定します; ansible_become がnoに設定されている場合、このキーは適用されません |
|
ansible_network_os |
はい | dellos6/dellos9/dellos10, null* | リモートデバイスと通信するために正しい端末およびcliconfプラグインを読み込みます |
注意: アスタリスク (*) は、指定がない場合のデフォルト値を示します。
依存関係
dellos-logging役割は、Ansibleのコアコードに含まれるモジュールに基づいて構築されています。これらのモジュールは、Ansibleバージョン2.2.0で追加されました。
例プレイブック
この例では、dellos-logging役割を使用してログサーバーを完全に設定します。スイッチの詳細と対応する変数を持つhostsファイルを作成します。このhostsファイルは、ansible_network_os変数を対応するDell EMCネットワークOS名で定義する必要があります。dellos_cfg_generateがtrueに設定されると、変数は.bpartファイルとして設定コマンドをbuild_dirパスに生成します。デフォルトでは、この変数はfalseに設定されています。
サンプルhostsファイル
leaf1 ansible_host= <ip_address>
サンプルhost_vars/leaf1
hostname: leaf1
ansible_become: yes
ansible_become_method: xxxxx
ansible_become_pass: xxxxx
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9
dellos_logging:
logging:
- ip : 1.1.1.1
state: present
- ip: 2.2.2.2
secure_port: 1025
tcp_port: 1024
udp_port: 2000
state: present
- ip: 3.3.3.3
vrf:
name: test
secure_port: 1024
tcp_port: 1025
udp_port: 2000
state: present
secure_port: 1025
tcp_port: 2000
udp_port: 1025
state: present
buffer: 5
console_level: 7
trap_level: 5
syslog_version: 5
history: 4
history_size: 3
monitor: 5
on: true
extended: true
coredump:
server:
server_ip: 2.2.2.2
username: u1
password: pwd
state: present
stackunit:
all: true
unit_num: 5
state: present
source_interface: "fortyGigE 1/9"
ログ設定のためのシンプルなプレイブック - leaf.yaml
- hosts: leaf1
roles:
- Dell-Networking.dellos-logging
実行
ansible-playbook -i hosts leaf.yaml
(c) 2017 Dell Inc. またはその子会社。すべての権利を保有します。
The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.
ansible-galaxy install Dell-Networking.dellos-logging