スクリプトログのログソース構成

多くのリソースとサービスは API を使用してログにアクセスします。 これはカスタマイズが面倒な場合があり、API フィルターをサポートしていません。 LogSource は、LM ログを有効にし、ログ データの収集と転送を構成するのに役立つテンプレートを提供する LogicModule です。 LogSource には、どのログを取得するか、どこで取得するか、およびどのフィールドを解析対象として考慮する必要があるかに関する詳細が含まれています。

スクリプト ログ LogSource タイプは、API スクリプト タイプのログの LogicMonitor へのインポートを設定するのに役立ちます。 この LogSource タイプは、API を呼び出して定期的にログ データを収集するスクリプトを使用します。

LogicMonitorを使用すると、システムがイベントをフィルターに基づいて取り込む方法のフィルターロジックを構成できます。 AND or OR オペレータ。

スクリプトログ LogSource を構成するための要件

スクリプト ログ LogSource を構成するには、次のものが必要です。

• 使用するには OR フィルター演算子を使用する場合は、EA Collector 38.500以降をマシンにインストールしてください。詳細については、 コレクターの追加.

設定オプション

以下に、 スクリプトログ ログソースのタイプ。 LogSource を追加する方法の一般的な情報については、を参照してください。 LogSource の構成.

基本情報

 収集間隔 ドロップダウンで、スクリプトを実行する時間間隔を選択します。 デフォルトは XNUMX 時間です。 

収集

 収集 セクションで指定したリソースからログ データを収集するための Groovy 形式のインポート スクリプトを追加します。 に適用されます のセクションから無料でダウンロードできます。 

フィルタを含める

切り替えることができます ANDの代わりにORを使用する スイッチを使用してフィルターを評価する AND or OR 演算子。デフォルトでは、 ANDの代わりにORを使用する スイッチは無効です。以下の演算子を使用してフィルターを評価できます。

• AND 演算子—フィルターは AND 演算子。指定されたすべてのフィルターに一致するイベントがシステムによって取り込まれます。 
• OR 演算子— ANDの代わりにORを使用する スイッチを使用してフィルターを評価する OR 演算子。システムは、少なくとも 1 つのフィルターに一致するイベントを取り込みます。

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

利用可能なパラメータ

ログフィールド

ログフィールド (タグ) を構成して、ログとともに追加のメタデータを送信できます。 

利用可能なパラメータ

リソースマッピング

監視対象リソースと一致するように LM ログ プロパティを構成します。

利用可能なパラメータ

例

以下に、ログ イベントを取得するためのインポート スクリプトを作成するためのガイドラインを示します。 スクリプトを 収集 LogSource 構成のセクション。

ログ イベントは JSON オブジェクトです。 出力用の JSON オブジェクトを作成するときは、次のガイドラインに従ってください。

• JSON オブジェクトには、必須のカスタマイズされたイベント属性がすべて含まれています。
• これには、JSON 配列と、「ステータス」や「メッセージ」など、スクリプトのステータスを示すその他の属性が含まれています。
• JSON 配列には、LogicMonitor に報告されるすべてのイベントが含まれています。

次の構文は、出力 JSON オブジェクトを示しています。

output            ::= "{" "events" : "[" event ["," event]+ "]"," scriptAttribute]+ "}"
event             ::= "{" messageAttribute ["," customAttribute]+}
messageAttribute  ::= "message" ":" messageText
customAttribute   ::= attributeName ":" attributeValue
messageText       ::= <any string text>
attributeName     ::= <any valid name string allowed in system>
attributeValue    ::= <any string text>

単一イベントとしてのスクリプト出力

{
   "events": [
                {
                   "message":"This is the message of the event",
                   "customAttribute":"This is a custom attribute"
                }
            ]
}

終了コード

インポート スクリプトには、 成功終了コード 実行が成功したことを示します。 

• 任意の整数値を指定できます。 デフォルト値は「0」で、実行が成功したことを示します。
• 出力は、スクリプトが終了コード 0 で完了する場合にのみ処理されます。終了コードが指定されていない場合、部分的なイベント処理を避けるために、出力は破棄されます。

Jsonとしてスクリプト出力(println行)

このサンプル スクリプトは、「json (println 行)」として出力を提供し、実行が成功したことを示すリターン コード「0」を含みます。 このスクリプトには、イベント配列に必須の「メッセージ」属性も含まれています。

import groovy.json.*
 def get = new URL("sone-url").openConnection();
 def getRC = get.getInputStream().getText() 
 def json = new JsonSlurper().parseText(getRC)
 json.each { it.putAt("message", it.getAt("description")) }
 json.each { it.remove("description") }
 JsonBuilder builder = new JsonBuilder(json)
 builder {
 events builder (json)
  }       println(builder.toPrettyString())
 return 0