Cisco Nexus 9000 シリーズ NX-OS プログラマビリティ ガイド、リリース 10.4(x)

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ
このマニュアル内で検索
ご利用いただける言語
Download Options

Book Title

Cisco Nexus 9000 シリーズ NX-OS プログラマビリティ ガイド、リリース 10.4(x)

Chapter Title

ダイナミック ロガー

検索結果

Updated:
2023年8月18日金曜日

章のタイトル： ダイナミック ロガー

ダイナミック ロガー

前提条件

ダイナミック ロギングを使用する前に、スイッチに次のものが存在することを確認します。

  • libmtxlogmgr*.so ライブラリが /opt/mtx/lib/ にインストールされていること。libmtxlogmgr*.so ライブラリは、mtx_infra RPM の一部です。

  • mtx.conf ファイルが /etc/ にあること。 

    [mtxlogger]
config=/opt/mtx/conf/mtxlogger.cfg

  • mtxlogger.cfg ファイルが /opt/mtx/conf/ にあること。

参照先

構成ファイルの構造は次のとおりです。

<config name="nxos-device-mgmt">
  <container name="mgmtConf">
    <container name="logging">
      <leaf name="enabled" type="boolean" default="false"></leaf>
      <leaf name="allActive" type="boolean" default="false"></leaf>
      <container name="format">
        <leaf name="content" type="string" default="$DATETIME$ $COMPONENTID$ $TYPE$: $MSG$"></leaf>
	    <container name="componentID">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
	    </container>	
	    <container name="dateTime">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
            <leaf name="format" type="string" default="%y%m%d.%H%M%S"></leaf>
	    </container>	
	    <container name="fcn">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
            <leaf name="format" type="string" default="$CLASS$::$FCNNAME$($ARGS$)@$LINE$"></leaf>
	    </container>	
      </container>
      <container name="dest">
        <container name="console">
          <leaf name="enabled" type="boolean" default="false"></leaf>         
        </container>
        <container name="file">
          <leaf name="enabled" type="boolean" default="false"></leaf>  
          <leaf name="name" type="string" default="mtx-internal.log"></leaf>
          <leaf name="location" type="string" default="./mtxlogs"></leaf>
	   <leaf name="mbytes-rollover" type="uint32" default="10"></leaf>
	   <leaf name="hours-rollover" type="uint32" default="24"></leaf>
	   <leaf name="startup-rollover" type="boolean" default="false"></leaf>
          <leaf name="max-rollover-files" type="uint32" default="10"></leaf>
        </container>
      </container>
      <list name="logitems" key="id">
        <listitem>
        	<leaf name="id" type="string"></leaf>
		 <leaf name="active" type="boolean" default="true"></leaf>
        </listitem>
      </list>
    </container>
  </container>
</config>

<list> タグは、<componentID> によるログ フィルタを定義します。

次の表では、コンテナとそのリーフの一部について説明します。

表 1. コンテナとリーフの説明

コンテナ

コンテナの説明

含まれるコンテナ

含まれるリーフと説明

logging

すべてのロギング データ タイプが含まれます。

形式

dest

ファイル

（注）  

 

リストタグ「logitems」も含まれます

enabled：ロギングがオンかオフかを決定するブール値です。デフォルトはオフです。

allActive：ロギング用に定義されたすべてのロギング項目をアクティブにするブール値です。デフォルトはオフです。

形式

ログ メッセージの形式情報を格納します。

componentID

dateTime

type

fcn

content：ログ メッセージに含まれるデータ型をリストする文字列です。内容：

  • $DATETIME$：ログ メッセージに日付または時刻を含めます。

  • $COMPONENTID$：ログ メッセージにコンポーネント名を含めます。

  • $TYPE$：メッセージタイプ（""、INFO、WARNING、ERROR）を含めます。

  • $SRCFILE$：ソース ファイルの名前を含めます。

  • $SRCLINE$：ソース ファイルの行番号を含めます。

  • $FCNINFO$ ソース ファイルからの class::関数名を含めます。

  • $MSG$：実際のログ メッセージ テキストを含めます。

componentID

ログが記録されたコンポーネントの名前です。

該当なし

enabled：ログ メッセージにコンポーネント ID を含めるかどうかを決定するブール値です。デフォルトは「true」です。値を「false」にすると、ログ メッセージに "" 文字列を返します。

dateTime

ログ メッセージの日付または時刻です

該当なし

enabled：ログ メッセージに日付または時刻の情報を含めるかどうかのブール値です。デフォルトはイネーブルです。

format：ログ メッセージに含める値を示す文字列です。フォーマットは %y%m%d.%H%M%Sです。

dest

接続先ロガーの構成設定を保持します。

console：接続先コンソールです。許可されるのは 1 つだけです。

file：接続先ファイルです。複数ファイルが許可されます。

該当なし

コンソール

接続先コンソール

該当なし

enabled：コンソールのロギングが有効かどうかを決定するブール値です。デフォルトは「false」です。

ファイル

接続先ファイルの設定を決定します。

該当なし

enabled：接続先が有効にされているかどうかを決定するブール値です。デフォルトは「false」です。

name：接続先ログ ファイルを示す文字列です。デフォルトは「mtx-internal.log」です。

location：接続先ファイル パスを示す文字列です。デフォルトは「./mtxlogs」です。

mbytes-rollover：システムが最も古いデータを上書きするまでのログファイルの長さを決定する uint32 値です。デフォルトは 10 M バイトです。

hours-rollover：時間単位でのログファイルの長さを決定する uint32 値です。デフォルトは 24 時間です。

startup-rollover：エージェントの起動時または再起動時にログファイルをロールオーバーするかどうかを決定するブール値です。デフォルト値は「false」です。

max-rollover-files：ロールオーバー ファイルの最大数を決定する uint32 値です。 max-rollover-files の値を超えると、最も古いファイルが削除されます。デフォルト値は 10 です。

例

次に、デフォルトでインストールされている設定を含む設定ファイルを示します。
<config name="nxos-device-mgmt">
  <container name="mgmtConf">
    <container name="logging">
      <leaf name="enabled" type="boolean" default="false">true</leaf>
      <leaf name="allActive" type="boolean" default="false">false</leaf>
      <container name="format">
        <leaf name="content" type="string" default="$DATETIME$ $COMPONENTID$ $TYPE$: $MSG$">$DATETIME$ $COMPONENTID$ $TYPE$ $SRCFILE$ @ $SRCLINE$ $FCNINFO$:$MSG$</leaf>
	    <container name="componentID">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
	    </container>	
	    <container name="dateTime">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
            <leaf name="format" type="string" default="%y%m%d.%H%M%S"></leaf>
	    </container>	
	    <container name="fcn">
            <leaf name="enabled" type="boolean" default="true"></leaf>         
            <leaf name="format" type="string" default="$CLASS$::$FCNNAME$($ARGS$)@$LINE$"></leaf>
	    </container>	
      </container>
      <container name="dest">
        <container name="console">
          <leaf name="enabled" type="boolean" default="false">true</leaf>         
        </container>
        <container name="file">
          <leaf name="enabled" type="boolean" default="false">true</leaf>  
          <leaf name="name" type="string" default="mtx-internal.log"></leaf>
          <leaf name="location" type="string" default="./mtxlogs">/volatile</leaf>
	   <leaf name="mbytes-rollover" type="uint32" default="10">50</leaf>
	   <leaf name="hours-rollover" type="uint32" default="24">24</leaf>
	   <leaf name="startup-rollover" type="boolean" default="false">true</leaf>
          <leaf name="max-rollover-files" type="uint32" default="10">10</leaf>
        </container>
      </container>
      <list name="logitems" key="id">
        <listitem>
        	<leaf name="id" type="string">*</leaf>
		 <leaf name="active" type="boolean" default="false">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">SYSTEM</leaf>
		 <leaf name="active" type="boolean" default="true">true</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">LIBUTILS</leaf>
		 <leaf name="active" type="boolean" default="true">true</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">MTX-API</leaf>
		 <leaf name="active" type="boolean" default="true">true</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">Model-*</leaf>
		 <leaf name="active" type="boolean" default="true">true</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">Model-Cisco-NX-OS-device</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">Model-openconfig-bgp</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">INST-MTX-API</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">INST-ADAPTER-NC</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">INST-ADAPTER-RC</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
        <listitem>
        	<leaf name="id" type="string">INST-ADAPTER-GRPC</leaf>
		 <leaf name="active" type="boolean" default="true">false</leaf>
        </listitem>
      </list>
    </container>
  </container>
</config>

このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ