Syslog ログソース構成

LogSource は、LM ログに取り込まれる Syslog ログと、それらをリソースにマッピングする方法を設定できるロジックモジュールです。Syslog LogSource を Collector 自体に適用して Syslog 処理を広範に制御することも、個々のリソースに適用してより詳細な制御を行うこともできます。 

すべてのLM Collectorには、Syslog取り込み用のデフォルトのLogSourceがあらかじめ設定されています。このLogSourceは、シンプルなセットアップ、検索可能なログビューとアラート、容易なフィルタリング、そして追加ソースのライセンスやエージェントが不要なため、Syslog取り込みに最適な、すぐに使えるソリューションです。 

コレクターSyslog処理

LogSource をコレクタに適用すると、コレクタは次の方法で Syslog を処理できます。

• コレクターが受信した Syslog イベントを取り込むことが要件の場合は、コレクターの Agent.conf プロパティ「lmlogs.syslog.enabled」を有効にできます。このプロパティは、オンにすることによっても有効にすることができます。 Syslog と SNMP のログ収集を有効にする トラップ オプション コレクターを追加 ページ。このプロパティを有効にすると、コレクターはフィルターやリソース マッピングなどのカスタマイズを行わずに、すべての Syslog イベントを取り込みます。
• 一部の Syslog イベントのフィルタリングやリソース マッピングの別のメソッドの追加など、カスタマイズを追加する必要がある場合は、LogSource を作成し、Syslog 受信コレクタに適用できます。 コレクターに申し込む LogSource のオプション。
• 特定の LogSource 定義を使用してデバイスからの Syslog イベントを処理することが要件の場合、Syslog イベントをコレクタに転送するデバイスに通常の LogSource を適用できます。 

デバイスに適用される通常の LogSource は、syslog を処理するコレクタに適用される LogSource よりも優先されます。

コレクタに適用される LogSource は、syslog を処理するためにコレクタのagent.conf プロパティ「lmlogs.syslog.enabled」よりも優先されます。

次のシナリオは、syslog を受信するコレクターによる syslog 処理の優先設定を理解するために参照できます。

*次の場合、デバイスはコレクターによって監視されていると言われます。

• コレクターは次のように割り当てられます。 優先コレクター on リソースの管理 ページ
  - または -
• コレクタは、次を使用してログ コレクタとして割り当てられます。 LM ログ コレクターの設定 オプションオン リソースの管理 ページ

Syslogログを処理するためにLogSourceにCollectorを適用する方法の詳細については、以下を参照してください。 LogSource をコレクターに適用する.

フィルタを含める

アプリケーションなど、特定の種類のリソースを含めるためのフィルターを追加できます。フィルター条件に一致する出力は、ログ取り込みプロセスに転送されます。

次の表に、使用可能なパラメータの詳細を示します。

ログフィールド

ログフィールド（タグ）を設定することで、ログに追加のメタデータを送信できます。利用可能なパラメータは以下の表のとおりです。

リソースマッピング

監視対象リソースに合わせてLMログプロパティを設定します。使用可能なパラメータは以下の表のとおりです。

以下は、LMプロパティ（トークン）方式を用いたリソースマッピングの例です。この例では、LMポータル内の監視対象デバイスの1つにマッピングするプロパティを指定します。LMプロパティのキーは次のとおりです。 token.resourceMap そしてその値は syslog_test_collector.

LogSourceがデバイスに適用されると、リソースマッピングはLM_propertyで次のように処理されます。 token.resourceMap、ソースとして LM Property解析メソッドは Token、そしてその値は、 ##、 といった ##token.resourceMap##.

コレクターはフィードからホストエントリを受信し、 ##token.resourceMap## LM_propertyに対して受け取った値 token.resourceMap その特定のホスト（例えば、 syslog_test_collector).

ログソースが適用されるリソースが複数ある場合、 LM_property 一意である必要があります。一意でない場合、Ingest API はリソースにマッピングしません。

以下の画像は、 syslog_test_collector 例。  

次の画像は、LogSourceのリソースマッピングからのものです。 syslog_test_collector 例。

この LogSource の Collector 側のリソース マッピングは次のとおりです。

'{"metadata":{"logSource_id":"2249","logsource_name":"syslog_test_token"},"Severity":"3: Error","Host":"localhost","epochWhenAddedInQueue":1633501246808,"Facility":"1: user-level messages","message":"<11>Just a message with metadata test_md1 !!\u0000","_lm.resourceId":{"token.resourceMap":"syslog_test_collector"},"timestamp":1633501246808,"_lm.collectorId":"48"}', raw:'<11>Example message with metadata test_md1 !!'

Syslog ログソースの設定要件

Syslogログを取り込むマシンにLM Collectorがインストールされている必要があります。詳細については、 LogicMonitorコレクターについて.

Syslog ログソースの設定

1. LogicMonitorで、次の場所に移動します モジュール > 私のモジュールツールボックス。
2. 選択する .
3. 追加 モーダル、選択 ログソース.
4. 名 フィールドに、syslog ログのソースを説明する一意の名前を入力します。
5. 詳細説明 フィールドに、Syslogログのソースの説明を入力します。この説明は、ログソースの目的、機能、または設定の詳細を、自分や他のユーザーが理解するのに役立つ追加のコンテキストを提供します。
6. タグ フィールドで、ログ ソースに割り当てるタグ (ログ フィールドとも呼ばれます) を検索します。 
   注意： タグは、フィルタリング、グループ化、自動化に使用されるメタデータフィールドです。タグの詳細については、上記のログフィールドの表をご覧ください。
7. グループ フィールドで、ログソースを最も適切に分類するグループを1つ以上選択します。グループは通常、ログソースの機能、場所、または環境を反映します。 
8. テクニカルノート トラブルシューティングやメンテナンスに役立つ詳細な参照情報を提供するフィールドです。
9. トグル レンダリングされた技術ノートのプレビューを表示 スイッチを切り替えると、マークダウン形式のコンテンツがレンダリング時にどのように表示されるかが表示されます。
10. をセットする タイプ ドロップダウンメニュー LM ログ: SysLog.
11. トグル ログスタンプの代わりに受信時刻を使用する syslog メッセージに埋め込まれたタイムスタンプではなく、LogicMonitor が syslog メッセージを受信した時点に基づいてタイムスタンプを使用するように切り替えます。
12. 追加 アクセスグループ ログを表示、管理、操作できるユーザーを有効にします。
13. に適用されます フィールドで、このLogSourceを適用するリソースを定義します。例えば、以下のように、指定したグループ、タグ、またはコレクター内のデバイスにのみLogSourceを適用できます。

    isInDeviceGroup("Network Devices") 
    *Applies the logsource only to devices in the "Network Devices" group.
     
    system.env == "prod"
    *Applies to devices tagged with env:prod.
    
    collectorId == 27
    *Applies only to devices using a specific Collector.

14. 追加 フィルタ 上記の利用可能なパラメータを使用します。
15. デフォルトを確認する ログフィールド 必要に応じて編集します。
    
16. デフォルトを確認する リソースマッピング 必要に応じて編集します。
    
17. 選択する Save.

LogSource をコレクターに適用する

コレクタバージョンEA-35.200では、「コレクタに適用」オプションを使用して、LogSourceをコレクタに直接適用できます。また、「適用先」オプションを使用してLogSourceをデバイスに適用することもできます。ただし、EA-35.200より前のバージョンのコレクタを使用している場合は、「適用先」オプションを使用してのみLogSourceをデバイスに適用できます。

LogSource をコレクタに適用すると、次のシナリオで役立ちます。

• Syslog をコレクタに転送しているデバイスは、コレクタによって監視されません。
• Syslog をコレクタに転送しているデバイスは、LogicMonitor ではまったく監視されません。

LogSource をコレクターに適用するには:

1. LogSource の作成中に、 に適用されます タブ、トグル コレクターに申し込む スイッチ。
2.  コレクターのマッピング選択 コレクターの追加.