JavaScriptを使用してZabbixの実践的な問題を解決します

ティホン・ウスコフ、Zabbix 統合チーム エンジニア

Zabbix は、あらゆる種類のデータを監視するために使用されるカスタマイズ可能なプラットフォームです。 Zabbix の初期バージョン以来、監視管理者は、次の方法でさまざまなスクリプトを実行できました。 ターゲットネットワークノードのチェック用。 同時に、スクリプトの開始により、スクリプトのサポートの必要性、通信ノードやプロキシへの配信、さまざまなバージョンのサポートなど、多くの困難が生じました。

Zabbix 用の JavaScript

2019 年 4.2 月に、JavaScript 前処理を備えた Zabbix 3.4 が導入されました。 多くの人は、データをどこかに取得し、それをダイジェストして Zabbix が理解できる形式で提供し、Zabbix による保存や処理の準備ができていないデータを受け取る単純なチェックを実行するスクリプトの作成を放棄するというアイデアに興奮しました。次に、Zabbix および JavaScript ツールを使用してこのデータ ストリームを処理します。 Zabbix XNUMX で登場した低レベルの検出と依存項目と併せて、受信したデータを並べ替えて管理するためのかなり柔軟な概念が得られました。

Zabbix 4.4 では、JavaScript での前処理の論理的な継続として、新しい通知方法である Webhook が登場しました。これを使用すると、Zabbix 通知をサードパーティ アプリケーションと簡単に統合できます。

JavaScript とダクテープ

なぜ JavaScript と Duktape が選ばれたのですか? 言語とエンジンのさまざまなオプションが検討されました。

• ルア - ルア 5.1
• ルア - LuaJIT
• JavaScript - ダクテープ
• JavaScript – ジェリースクリプト
• 埋め込みPython
• 埋め込まれたPerl

主な選択基準は、普及率、製品へのエンジンの統合の容易さ、リソース消費の低さとエンジンの全体的なパフォーマンス、この言語のコードを監視に導入する際の安全性でした。 インジケーターの組み合わせに基づいて、JavaScript が Duktape エンジンに勝利しました。

選択基準と性能テスト

ダクテープの特徴:

- 標準 ECMAScript E5/E5.1
— Duktape 用の Zabbix モジュール:

• Zabbix.log() - さまざまな詳細レベルのメッセージを Zabbix Server ログに直接書き込むことができます。これにより、たとえば Webhook 内のエラーとサーバーの状態を関連付けることができます。
• CurlHttpRequest() - Webhook の使用のベースとなるネットワークに対して HTTP リクエストを行うことができます。
• atob() および btoa() - Base64 形式で文字列をエンコードおよびデコードできます。

NOTE. Duktape は ACME 規格に準拠しています。 Zabbix は 2015 バージョンのスクリプトを使用します。 その後の変更は軽微なので無視してかまいません。.

JavaScript の魔法

JavaScript のすべての魔法は、動的な型指定と型キャスト (文字列、数値、ブール値) にあります。

これは、変数がどのような型の値を返すかを事前に宣言する必要がないことを意味します。

数学演算では、関数演算子によって返される値は数値に変換されます。 このような演算の例外は加算です。これは、用語の少なくとも XNUMX つが文字列である場合、文字列変換がすべての用語に適用されるためです。

NOTE. このような変換を担当するメソッドは通常、オブジェクトの親プロトタイプに実装されます。 値の и toString. 値の 数値変換中、常にメソッドの前に呼び出されます。 toString. 方法 値の プリミティブ値を返さなければなりません。それ以外の場合、その結果は無視されます。

オブジェクトに対してメソッドが呼び出される 値OF。 見つからない場合、またはプリミティブ値を返さない場合、メソッドが呼び出されます。 toString。 方法の場合 toString 見つからない、検索中 値の オブジェクトのプロトタイプ内で、値の処理が完了し、式内のすべての値が同じ型にキャストされるまで、すべてが繰り返されます。. オブジェクトがメソッドを実装している場合 toString、プリミティブ値を返す場合、それが文字列変換に使用されます。 ただし、このメソッドを適用した結果は必ずしも文字列であるとは限りません。

たとえば、オブジェクト ' の場合オブジェクト'メソッドが定義されています toString,

`var obj = { toString() { return "200" }}` 

方法 toString 正確に文字列を返します。数値を含む文字列を追加すると、結合された文字列が得られます。

`obj + 1 // '2001'` 

`obj + 'a' // ‘200a'`

でも書き直すと toString, メソッドが数値を返すように、オブジェクトが加算されると、数値変換を伴う数学演算が実行され、数学的加算の結果が取得されます。

`var obj = { toString() { return 200 }}` 

`obj + 1 // '2001'`

この場合、文字列で加算を実行すると、文字列変換が実行され、結合された文字列が得られます。

`obj + 'a' // ‘200a'`

これが、JavaScript の初心者ユーザーによる多数の間違いの原因です。

方法 toString オブジェクトの現在の値を 1 増やす関数を作成できます。

変数が 3 に等しく、また 4 にも等しい場合に、スクリプトが実行されます。

キャスト (==) と比較すると、毎回メソッドが実行されます。 toString 値増加機能付き。 したがって、後続の比較ごとに、値は増加します。 これは、非キャスト比較 (===) を使用することで回避できます。

型キャストなしの比較

NOTE. 不必要にキャスト比較を使用しないでください.

複雑なロジックを備えた Webhook など、型キャストとの比較が必要な複雑なスクリプトの場合は、変数を返し、不一致やエラーを処理する値のチェックを事前に作成することをお勧めします。

Webhook メディア

2019 年末から 2020 年初めにかけて、Zabbix 統合チームは、Zabbix ディストリビューションに付属する Webhook とすぐに使える統合の開発を積極的に行ってきました。

• Discord
• JIRA
• Jiraサービスデスク
• Mattermost
• マイクロソフトのチーム
• オプスジェニー
• OTR
• Pagerduty
• だまされやすい人
• Redmineの
• ServiceNow
• シングル4
• Slack
• Telegram
• ザマド
• のZendesk

リンク先 ドキュメンテーション

前処理

• JavaScript での前処理の出現により、ほとんどの外部スクリプトを放棄することが可能になり、現在 Zabbix では任意の値を取得して、それをまったく別の値に変換できます。
• Zabbix での前処理は JavaScript コードによって実装され、バイトコードにコンパイルされると、単一の値をパラメーターとして受け取る関数に変換されます。 値 文字列として (文字列には数字と数字の両方を含めることができます)。
• 出力は関数であるため、スクリプトの最後に return.
• コード内でカスタム マクロを使用することが可能です。
• リソースは、オペレーティング システム レベルだけでなく、プログラム的にも制限できます。 前処理ステップには、最大 10 メガバイトの RAM と 10 秒の実行時間制限が割り当てられます。

NOTE. かなり「重い」前処理シナリオに従って 10 秒間に条件付きの数千のデータ項目を収集すると、Zabbix の速度が低下する可能性があるため、1 秒というタイムアウト値は非常に長い値です。 したがって、前処理を実行するためだけに実行される、いわゆるシャドウ データ要素 (ダミー アイテム) を通じて本格的な JavaScript スクリプトを実行するために前処理を使用することはお勧めできません。.

前処理テストまたはユーティリティを使用してコードをチェックできます。 zabbix_js:

`zabbix_js -s *script-file -p *input-param* [-l log-level] [-t timeout]`

`zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]`

`zabbix_js -h`

`zabbix_js -V`

実践的なタスク

タスク 1

計算項目を前処理に置き換えます。

状態: センサーから温度を華氏で取得し、摂氏で保存します。

以前は、温度を華氏で収集するアイテムを作成していました。 その後、数式を使用して華氏を摂氏に変換する別のデータ項目 (計算済み)。

問題:

• データ要素を複製し、すべての値をデータベースに保存する必要があります。
• 計算され、数式で使用される「親」データ項目と、計算されるデータ項目の間隔について合意する必要があります。 そうしないと、計算項目がサポートされていない状態になったり、以前の値が計算されたりする可能性があり、監視結果の信頼性に影響します。

XNUMX つの解決策は、柔軟なチェック間隔をやめて固定間隔を選択し、データ (この場合は華氏での温度) を受け取った項目の後で計算項目が評価されるようにすることでした。

しかし、たとえば、テンプレートを使用して多数のデバイスをチェックし、そのチェックが 30 秒ごとに実行される場合、Zabbix は 29 秒間「ハッキング」し、最後の XNUMX 秒でチェックと計算を開始します。 これによりキューが作成され、パフォーマンスに影響します。 したがって、本当に必要な場合にのみ固定間隔を使用することをお勧めします。

この問題の最適な解決策は、華氏を摂氏に変換する XNUMX 行の JavaScript 前処理です。

`return (value - 32) * 5 / 9;`

迅速かつ簡単で、不要なデータ項目を作成して履歴を保持する必要がなく、柔軟な間隔でチェックすることもできます。

`return (parseInt(value) + parseInt("{$EXAMPLE.MACRO}"));`

ただし、仮定の状況で、たとえばマクロで定義された定数を使用して、受信したデータ要素を追加する必要がある場合は、パラメータが 値 文字列に展開されます。 文字列の加算演算では、XNUMX つの文字列が単純に XNUMX つに結合されます。

`return (value + "{$EXAMPLE.MACRO}");`

算術演算の結果を取得するには、取得した値の型を数値形式に変換する必要があります。 このために、関数を使用できます parseInt（）、整数、関数を生成します。 parseFloat()、小数または関数を生成します。 数、整数または小数を返します。

2タスク

証明書が終了するまでの時間を秒単位で取得します。

状態: サービスは証明書の有効期限を「12 年 12 月 33 日 56:2022:XNUMX GMT」の形式で発行します。

ECMAScript5では Date.parse（） ISO 8601 形式 (YYYY-MM-DDTHH:mm:ss.sssZ) の日付を受け入れます。 MMM DD YYYY HH:mm:ss ZZ の形式で文字列をキャストする必要があります。

問題: 月の値は数値ではなくテキストとして表されます。 この形式のデータは Duktape では受け入れられません。

ソリューション例:

• まず、値を受け取る変数が宣言されます (スクリプト全体は、カンマで区切ってリストされた変数の宣言です)。

• 最初の行ではパラメータの日付を取得します。 値 メソッドを使用してスペースで区切ります split。 したがって、インデックス 0 から始まる配列の各要素がスペースの前後の XNUMX つの日付要素に対応する配列が得られます。 分割(0) - 月、 分割(1) - 番号、 分割(2) - 時刻を含む文字列など。その後、配列内のインデックスによって日付の各要素にアクセスできます。

`var split = value.split(' '),`

• 各月 (時系列順) は、配列内のその位置のインデックス (0 から 11) に対応します。 テキスト値を数値に変換するには、月のインデックスに 1 が追加されます (月の番号は XNUMX から始まるため)。 この場合、XNUMX を追加した式は括弧で囲まれます。そうしないと、数値ではなく文字列が取得されるからです。 最後にやります スライス（） - 配列を末尾から切り取って XNUMX 文字だけを残します (これは XNUMX 桁の数字を含む月の場合に重要です)。

`MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],`

`month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),`

• 通常、適切な順序で文字列を追加することにより、取得した値から ISO 形式の文字列を形成します。

`ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],`

結果として得られる形式のデータは、1970 年から将来のある時点までの秒数です。 Zabbixではマクロのみで操作できるため、受け取った形式のデータをトリガーで使用することはほぼ不可能です。 {日付} и {時間}、日付と時刻を使いやすい形式で返します。

• 次に、JavaScript で Unix タイムスタンプ形式で現在の日付を取得し、結果として得られる証明書の有効期限日からそれを減算して、現在から証明書の有効期限が切れるまでのミリ秒数を取得します。

`now = Date.now();`

• Zabbix では、受信した値を XNUMX で割って秒を取得します。

`return parseInt((Date.parse(ISOdate) - now) / 1000);`

トリガーでは、式 ' を指定できます。最後' の後に、応答する期間の秒数 (週単位など) に対応する一連の数字が続きます。 したがって、トリガーは証明書が XNUMX 週間で期限切れになることを通知します。

NOTE. 使用に注意してください parseInt（） 機能的に returnミリ秒を除算した結果の小数を整数に変換します。 も使用できます parseFloat() 部分データを保存します.

レポートを見る

出所： habr.com