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
ライセンス
apache-2.0
ダウンロード
68.2k