xymongen - クラウドでオンライン

プログラム：

NAME

xymongen - Xymon ウェブページジェネレーター

SYNOPSIS

クシモンゲン -?
クシモンゲン - 助けて
クシモンゲン - バージョン
クシモンゲン [オプション] [出力ディレクトリ]
(使用可能なコマンドライン オプションの説明については、「オプション」セクションを参照してください)。

DESCRIPTION

クシモンゲン Xymon モニターの概要 Web ページを生成します。 これらはウェブページです
各テストの詳細なステータス ページではなく、ホストの全体的なステータスが表示されます。

注: Web ページのデータは、 キシモンド(8) デーモン、および xymongen が使用する
ネットワークを決定するための XYMSRV / XYMSERVERS 環境変数の値
xymond に到達できるアドレス。 複数のサーバーがリストされている場合は、
XYMSERVERS、最初のサーバーがローカル Xymon サーバーであることを確認してください。これは、
xymongen はデータをクエリします。

OPTIONS

xymongen には多数のコマンドライン オプションがあります。 オプションを使用して変更できます
xymongen の動作に影響を与え、xymongen によって生成された Web ページに影響を与えます。

全般的な OPTIONS

--助けてください、それとも-?
使用可能なコマンドライン オプションの概要を提供します。

- バージョン
xymongen のバージョン番号を出力します。

--docurl=URL
このオプションは非推奨です。次の HOSTDOCURL 設定を使用してください。 xymonserver.cfg(5)
を代わりにお使いください。

--docccgi=URL
このオプションは非推奨です。次の HOSTDOCURL 設定を使用してください。 xymonserver.cfg(5)
を代わりにお使いください。

--doc-ウィンドウ
ホストおよびサービスのドキュメントへのリンクが新しいウィンドウで開きます。 の
デフォルトでは、Xymon ステータスと同じブラウザ ウィンドウにドキュメントが表示されます。

--htmlextension=.EXTENSION
xymongen によって生成される Web ページに使用されるファイル名拡張子を設定します。 に
デフォルトでは、拡張子「.html」が使用されます。 「ドット」を指定する必要があることに注意してください。

--レポート[=列名]
このオプションを使用すると、xymongen は、その数の詳細を含むステータス メッセージを送信します。
処理されたホスト、生成されたページ数、発生したエラー
実行中、およびいくつかのタイミング統計。 デフォルトの列名は「xymongen」です。

--htaccess[=htaccess ファイル名]
新しい Web ページ ディレクトリを作成するときに .htaccess ファイルを作成します。 の内容
.htaccess ファイルは、XYMONHTACCESS 環境変数によって決定されます (
最上位ディレクトリには xymon.html と nongreen.html が含まれます)。 によって
XYMONPAGEHTACCESS 変数 (ページレベルのディレクトリ用)。 そして、によって
サブページおよびサブ親レベルのディレクトリの XYMONSUBPAGEHTACCESS 変数。 の
ファイル名が指定されていない場合、.htaccess ファイルのファイル名はデフォルトで「.htaccess」になります。
このオプション。 XYMONHTACCESS 変数は、そのままトップレベルにコピーされます。
.htaccess ファイル。 XYMONPAGEHTACCESS 変数には「%s」が含まれる場合があります。ここで、名前は
のページが挿入されます。 XYMONSUBPAGEHTACCESS 変数には XNUMX つの「%s」が含まれる場合があります
インスタンス: 最初のインスタンスはページ名に置き換えられ、XNUMX 番目のインスタンスはページ名に置き換えられます。
サブページ名。

--max-eventcount=N
「緑色以外のすべて」ページのイベントログを N イベントのみに制限します。 デフォルト: 100。

--max-eventtime=N
「緑色以外のすべて」ページのイベントログを、その範囲内で発生したイベントに限定します。
N分経過。 デフォルト: 240。

--no-イベントログ
通常「緑色以外のすべて」ページに表示されるイベントログを無効にします。

--max-ackcount=N
「緑色以外のすべて」ページの確認ログを N 個のイベントのみに制限します。 デフォルト：
25.

--max-acktime=N
「緑色以外のすべて」ページの確認ログを、発生した確認応答に限定します。
過去 N 分以内。 デフォルト: 240。

--ノー・アクログ
通常「緑色以外のすべて」ページに表示される確認ログを無効にします。

--cricitcalllog[=重要なログ列]
これにより、critical.html ステータス ページに表示される内容のテキストベースのログが生成されます。
そして、Xymon サーバー自体の色を反映したステータス メッセージを送信します。
重大なステータスのページ。 これにより、いつ問題が発生したかを追跡できます。
重大なステータスのページ。 ログファイルは $XYMONSERVERLOGS/criticalstatus.log に保存されます。

--loadhostsfromxymond
hosts.cfg ファイルを読み取る代わりに、xymongen は hosts.cfg をロードします。
xymond デーモンからの設定。 これにより、
hosts.cfg、および xymond と xymongen を別のホストで実行している場合は、
これにより、システム間で hosts.cfg ファイルをコピーする必要がなくなります。 注意してください。
このオプションが有効な場合、hosts.cfg の「dispinclude」オプションは無視されます。

ページ レイアウト OPTIONS

これらのオプションは、xymongen によって生成された Web ページがブラウザーでどのように表示されるかに影響します。

--最後のページ
ページリンクとサブページリンクをホストの後に置きます。

--ページファースト
ページリンクとサブページリンクをホストの前に置きます (デフォルト)。

これら XNUMX つのオプションは、サブページおよびホストへのリンクを含むページに
最初にホストまたはサブページを選択します。

--subpagecolumns=N
ページおよびサブページへのリンクに使用される列の数を決定します。 デフォルト
N=1です。

--maxrows=N
ページ上の列見出しは、デフォルトではページの先頭にのみ表示されます。
サブページまたはホストのグループ。 このオプションを使用すると、列見出しが繰り返されます。
N 個ごとのホストが表示されます。

--showemptygroups

--no-showemptygroups
ホストごとにグループを作成した場合、テーブル名とホスト名が存在する場合でも表示するようにしました。
問題のホストにはテストが存在しません。 --no-showemptygroups を使用して、
隠れる。 (デフォルト: はい)

--pagetitle-links
通常、ページまたはサブページの隣にある色付きの「ドット」のみが、
ページ自体。 このオプションを使用すると、ページ タイトルもページにリンクされます。

--pagetext-Headings
「ページ」または「サブページ」タグの説明テキストを見出しとして使用します。
「ローカルでホストされているページ」またはその他の標準的な見出しの代わりに、ページを使用します。

--下線なしの見出し
通常、ページ見出しには HTML の「水平ルーラー」タグを使用して下線が付けられます。 これ
オプションは見出しの下線を無効にします。

--recentgifs[=分]
テストステータスが変更されたテストには、COLOR-recent.gif という名前の画像を使用します。
過去 24 時間以内。 これらの GIF ファイルは次の場所にインストールする必要があります。
$XYMONHOME/www/gifs/ ディレクトリ。 デフォルトでは、しきい値は 24 時間に設定されています。
別の方法が必要な場合は、時間制限を指定することもできます。 例えば
「--recentgifs=3h」は、ステータス変更後 3 時間だけ最近の GIF を表示します。

--sort-group-only-items
通常の「グループのみ」ディレクティブでは、テストの順序を指定できます。
左から右へ表示されます。 にリストされているテストを希望する場合は、
アルファベット順の場合は、このオプションを使用します。ページは「グループのみ」を生成します。
グループは通常のグループを生成するのと同様に、テストをアルファベット順に並べ替えます。

--dialupskin=URL
テストがダイヤルアップ テストであることを視覚的に示したい場合は、代替テストを使用できます。
緑/赤/黄>/などのアイコンのセット。 このオプションを指定すると画像が表示されます。 の
ここで指定された URL パラメータは、XYMONSKIN の通常の設定をオーバーライドします。
環境変数ですが、ダイヤルアップ テストのみに使用されます。

--reverseskin=URL
「--dialupskin」と同じですが、逆方向のテスト (先頭に「!」が付いているテスト) 用です。

--tooltips=[常に、決して、メイン]
ホストの説明を表示するためにツールチップを使用するページを決定します (
のコメントエントリ ホスト.cfg(5) ファイル）。 に設定されている場合 常に、ツールチップはすべてで使用されます
ページ。 に設定されている場合 決して、ツールチップは決して使用されません。 に設定されている場合 メイン、ツールチップが使用されます
メイン ページにはありますが、「すべての非グリーン」ページまたは「重要なシステム」ページにはありません。

カラム SELECTION OPTIONS

これらのオプションは、によって生成される Web ページにどの列 (テスト) が含まれるかに影響します。
キシモンゲン。

--ignorecolumns=テスト[,テスト]
指定された列は、Web ページの生成時に xymongen によって完全に無視されます。
ノイズの多いテストの一部を除外したレポートの生成に使用できます。
「メッセージ」のように。

--クリティカルレッドのみ
「重要」ページには赤色のステータス列のみが含まれます。 デフォルトでは、
クリティカル ページには、赤色、黄色、透明のステータスを持つホストが含まれます。

--nongreen-colors=COLOR[,COLOR]
「緑色以外のすべて」ステータス ページにテストを表示させる色を定義します。
色は赤、黄、紫のいずれかです。 デフォルトでは、XNUMX つすべてが含まれます。

--nongreen-ignorecolumns=テスト[,テスト]
--ignorecolumns と同じですが、「緑色以外のすべて」ページのホストにのみ適用されます。

--nongreen-ignorepurples
非推奨のため、代わりに「--nongreen-colors」を使用してください。

--nongreen-ignoredialups
「緑色以外のすべて」ページにあるすべてのダイヤルアップ ホスト (イベント ログを含む) を無視します。

--ページなし
通常のページを生成しません (通常は、緑色以外のページのみを生成するために使用されます)
ページ）。

--非緑なし
「すべて非緑色」ページを生成しません。

--includecolumns=テスト[,テスト]
「すべての非緑色」ページには常にこれらの列を含めます 特定の列も含めます
色に関係なく、nongreen.html ページ上で。 通常、nongreen.html は
test-column (すべてのテストが緑色の場合)。 これは、たとえば、常にへのリンクを持つために使用できます。
nongreen.html ページのトレンド列 (RRD グラフ付き)。

--eventignore=テスト[,テスト]
「緑色以外のすべて」イベント ログ表示にあるこれらのテストは無視してください。

ステータス 伝搬 OPTIONS

これらのオプションは、ページ階層の上方へのステータスの通常の伝播を抑制します。
したがって、テストのステータスが黄色または赤色であっても、ページ全体が緑色のままである可​​能性があります。
これは、アラームを発生させる必要はないが、アラームを発生させる必要があるテストに役立ちます。
実際のステータス。 これらのオプションは、すべてのホストのグローバルなデフォルトを設定します。 NOPROPRED を使用できます
および NOPROPYELLOW タグ ホスト.cfg(5) ホストごとに同様の制限を適用するファイル
基本。

--noprop yellow=test[,test] または --noprop=test[,test]
黄色の場合、ステータスの上方への伝播を無効にします。 「--noprop」オプションは非推奨になりました
使用しないでください。

--noproppurple=テスト[,テスト]
PURPLEの場合、上向きのステータス伝播を無効にします。

--nopropred=テスト[,テスト]
赤または黄色の場合、上向きのステータス伝播を無効にします。

--nopropack=テスト[,テスト]
ステータスが確認された場合、上向きのステータス伝播を無効にします。 お望みならば
すべての確認済みテストの伝達を無効にするには、「--nopropack=*」を使用します。

PURPLE ステータス OPTIONS

紫色のステータスは、テスト ステータスのレポートが停止したときに発生します。 テストステータスは、
制限時間 - 通常 30 分 - この時間を過ぎると、テストは次のようになります。
紫の。

--purplelog=ファイル名
すべての紫色のステータス メッセージのログファイルを生成します。

ALTERNATE ページセット OPTIONS

--pageset=ページセット名
デフォルトとは異なる代替ページセットの Web ページを構築します。 「ページセット」セクションを参照してください。
を参照してください。

--template=テンプレート
ヘッダー ファイルとフッター ファイルには代替テンプレートを使用します。 通常一緒に使用されるのは、
「--pageset」オプション; 以下の「ページセット」セクションを参照してください。

ALTERNATE 出力 書式

--wml[=test1,test2,...]
このオプションにより、xymongen は一連の WML 「カード」ファイルを生成します。
WAP デバイス (携帯電話、PDA など) によってアクセスされる。生成されたファイルには、
指定されたテストで RED または YELLOW ステータスを持つホスト。 このオプションで定義できるのは、
含めるデフォルトのテスト - デフォルトは、
「WML:」または「NK:」タグ ホスト.cfg(5) ファイル。 テストが指定されていない場合は、すべてのテストが
含まれます。

--nstab=ファイル名
Netscape 6/Mozilla サイドバー エントリに適した HTML ファイルを生成します。 実は
ユーザーがこのようなサイドバー エントリを取得できるようにするには、次の JavaScript コードが必要です。
Web ページ (たとえば、$XYMONHOME/web/stdnormal_header ファイルに含めることができます):


<!--
関数 addNetscapePanel() {
if ((typeof window.sidebar == "オブジェクト") &&
(window.sidebar.addPanel の種類 == "関数"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html"、"");
ほかに
alert("Mozilla または Netscape 6+ のみのサイドバー");
}
//->


次に、これをテンプレートとして使用して、「これをサイドバーに追加」リンクを含めることができます。

サイドバーに追加

または、標準の Netscape の「タブの追加」ボタンを使用したい場合は、そうします。
　


<IMG SRC="/gifs/add-button.gif" 高さ=45 幅=100
ALT="[サイドバーを追加]" STYLE="border:0">


「add-button.gif」は、Netscape から入手できます。
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

FILENAME がスラッシュで始まらない場合、Netscape サイドバー ファイルは
$XYMONHOME/www/ ディレクトリ。

--nslimit=COLOR
Netscape サイドバーに含める最小の色 - デフォルトは「赤」です。
重要なアラートのみが含まれます。 警告も含めたい場合は、次を使用します
「--nslimit=黄色」。

--rss Xymon アラートの RSS/RDF コンテンツ配信ストリームを生成します。 この出力形式は
ライブ ニュースフィードと同様に、他の Web ページに動的に埋め込むことができます。
ウェブサイトで見られます。 XNUMX つの RSS ファイルが生成され、XNUMX つは「すべての非
緑色のページ、もう XNUMX つは「重大」ページを表します。
それぞれ「nongreen.rss」ファイルと「critical.rss」ファイル。 さらに、RSS ファイル
ページおよび/またはサブページごとに生成され、そのページに存在するホストがリストされます。
ページまたはサブページ。
以前 --rss オプションで許可されていた FILENAME パラメータは廃止されました。
RSS/RDF コンテンツ フィードの詳細については、以下を参照してください。
http://www.syndic8.com/.

--rssextension=.EXTENSION
xymongen によって生成される RSS ファイルに使用されるファイル名拡張子を設定します。 に
デフォルトでは、拡張子「.rss」が使用されます。 「ドット」を指定する必要があることに注意してください。

--rssversion={0.91|0.92|1.0|2.0}
RSS/RDF フィードの目的の出力形式。 バージョン0.91が最も優れているようです
一般的に使用される形式であり、このオプションが省略された場合のデフォルトです。

--rsslimit=COLOR
RSS フィードに含める最小の色 - デフォルトは「赤」です。これは、のみを意味します。
重大なアラートが含まれます。 警告も含めたい場合は、次を使用します
「--rslimit=黄色」。

OPTIONS 中古 BY CGI フロントエンド

--reportopts=START:END:DYNAMIC:STYLE
レポート生成モードで xymongen を呼び出します。 これは通常、
レポート.cgi(1) CGI スクリプトですが、事前生成時に直接使用することもできます。
報告します。 START パラメータは、Unix time_t でのレポートの開始時刻です。
形式 (1 年 1970 月 00 日 00:XNUMX UTC からの秒数); END はレポートの終了時刻です。
DYNAMIC は、事前に作成されたレポートの場合は 0、動的 (オンライン) レポートの場合は 1 です。 スタイルは
クリティカル (赤) イベントのみを含める場合は「crit」、緑以外のすべてのイベントを含める場合は「nongr」
events、すべてのイベントを含む場合は「all」。

--csv=ファイル名
--reportopts と一緒に使用すると、xymongen が可用性を生成します。
カンマ区切り値 (CSV) ファイルの形式でレポートを作成します。 この形式が一般的です
さらに処理するためにスプレッドシートにインポートするために使用されます。
CSV ファイルには Unix タイムスタンプが含まれています。 これらを人間が判読できる時間として表示するには
エクセル、数式 =C2/86400+DATEVALUE(1 年 1970 月 XNUMX 日) (Unix タイムスタンプがある場合
セルC2)で使用できます。 結果のセルは日付/時刻としてフォーマットされる必要があります。
分野。 タイムスタンプは UTC であるため、ローカルのタイムスタンプも処理する必要がある場合があることに注意してください。
タイムゾーンと DST は自分で設定します。

--csvdelim=DELIMITER
デフォルトでは、CSV 出力のフィールドを区切るためにカンマが使用されます。 英語以外の人もいる
スプレッドシートでは、別の区切り文字 (通常はセミコロン) が使用されます。 CSVを生成するには
ファイルに適切な区切り文字が含まれている場合は、このオプションを使用して、使用する文字を設定できます。
区切り文字として。 例: "--csvdelim=;" - これは通常は二重である必要があることに注意してください
Unix シェルが区切り文字を文字として解釈するのを防ぐための引用符。
コマンドラインの区切り文字。

--スナップショット=時間
TIME に表示された Xymon ページのスナップショットを生成します。 TIMEは次のように与えられます
1 年 1970 月 00 日 00:XNUMX UTC からの秒数。 通常は次の方法で使用されます。 スナップショット.cgi(1) CGI
スクリプト。

デバッグ OPTIONS

- デバッグ
xymongen が大量のデバッグ出力を stdout にダンプします。
-DDEBUG を有効にしてコンパイルされました。 xymongen に関する問題を報告する場合は、次のことを行ってください。
問題を再現し、これで xymongen を実行した結果の出力を提供してみてください。
オプションを選択します。

- タイミング
xymongen のさまざまな部分で費やされた時間に関する情報を標準出力にダンプします。 これ
処理のどの部分が実行時に影響を与えているかを確認するのに役立ちます。
キシモンゲン。
注: この情報は、Xymon ディスプレイに送信される出力にも提供されます。
「--report」オプションを使用する場合。

ビル ALTERNATE ページセット

xymongen のバージョン 1.4 では、以下から複数のページ セットを生成できるようになりました。
同じデータです。
XNUMX つのグループの人が Xymon の Web ページを見ていると仮定します。 グループAが望んでいるのは、
ホストが所属するクライアントごとにグループ化されています。 これが Xymon のセットアップ方法です -
デフォルトのページセット。 ここで、グループ B はホストをオペレーティング システムごとにグループ化したいと考えています -
これを「os」セットと呼びます。 次に、次のようにページ レイアウトを hosts.cfg に追加します。

OSPAGE WIN Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
osgroup NT4 ファイルサーバー
osgroup NT4 メールサーバー
ossubpage win-xp MS Windows XP
ospage unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

これにより、XNUMX つのトップレベル ページ (xymon.html ページ) と XNUMX つのページからなる一連のページが定義されます。
xymon.html (win.html および unix.html) からリンクされており、たとえば win.html ページからは次のようになります。
サブページ win-nt4.html および win-xp.html
構文は、hosts.cfg の通常の「page」および「subpage」ディレクティブと同じですが、
ディレクティブにはページセット名が接頭辞として付けられます。 ページの間にホストを入れないでください
およびサブページ ディレクティブ - すべてのディレクティブを hosts.cfg ファイルの先頭に追加するだけです。
では、ページにホストを追加するにはどうすればよいでしょうか? シンプル - ホストにタグ「OS:win-xp」を置くだけです
定義行。 「OS」はページセット名に使用されるプレフィックスと同じである必要がありますが、
大文字。 「win-xp」は、この内で定義されているページまたはサブページの XNUMX つと一致する必要があります。
ページセット。 例えば

207.46.249.190 www.microsoft.com # OS:win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # OS:unix-sun http://www.sun.com/

そのページで定義されたグループ内にホストを表示したい場合は、そのホストを識別する必要があります。
1 から始まる番号ごとにグループ化します。たとえば、「NT4 メール サーバー」グループ内にホストを配置します。
上の例では、「OS:win-nt4,2」(「win-nt4」ページの XNUMX 番目のグループ) を使用します。
ホストをサブページではなくフロントページに表示したい場合は、 "OS:*" を使用します。

これらはすべて、新しいページセットのレイアウトを定義するだけです。 これを生成するには、次を実行する必要があります
定義するページセットごとに xymongen を XNUMX 回実行します。つまり、次のような拡張スクリプトを作成します。

#!/bin/sh

XYMONWEB="/xymon/os" $XYMONHOME/bin/xymongen \
--pageset=os --template=os \
$XYMONHOME/www/os/

これを $XYMONHOME/ext/os-display.sh に保存し、Xymon 拡張機能として実行するように設定します。
これは、tasks.cfg を実行するために追加のセクションを追加することを意味します。

これによりページが生成されます。 ここではいくつかの重要なオプションが使用されています。
* XYMONWEB="/xymon/os" 環境変数、および
「$XYMONHOME/www/os/」オプションは連携して機能し、
新しいページセットの HTML ファイルは通常のサブディレクトリにあります
ザイモンのウェブルート。 通常、Xymon ページにアクセスする場合は、
"http://xymon.acme.com/xymon/」とアクセスすると、
新しいページセットは「http://xymon.acme.com/xymon/os/"
注意: XYMONWEB として指定されたディレクトリには、シンボリック ファイルが含まれている必要があります。
$XYMONHOME/www/html/ ディレクトリへのリンク、またはへのリンク
個別のステータス メッセージは機能しません。 類似リンク
gifs/、help/、notes/ 用に作成する必要があります。
ディレクトリ。
* 「--pageset=os」は、xymongen に Web ページを構造化するよう指示します。
デフォルトのレイアウトの代わりに「os」レイアウトを使用します。
* 「--template=os」は、xymongen に別のセットを使用するように指示します。
ヘッダーとフッターのテンプレート。 通常、xymongen は
$XYMONHOME/web/stdnormal_header の標準テンプレートと
.../stdnormal_footer - このオプションを使用すると、代わりに使用されます。
ファイル「os_header」と「os_footer」
$XYMONHOME/web/ ディレクトリ。 これによりカスタマイズが可能になります
各ページセットのヘッダーとフッター。 ただ欲しいなら
通常のテンプレートを使用する場合は、このオプションを省略できます。

使用する キシモンゲン FOR レポート

xymongen レポートは、標準の Xymon のドロップイン置換によって実装されます。
Web サーバー cgi-bin にインストールされているレポート スクリプト (report.sh および reportlog.sh)
ディレクトリにあります。

これら XNUMX つのシェル スクリプトは、XNUMX つの非常に小さなシェル スクリプトに置き換えられました。
Xymon 環境変数を設定し、 レポート.cgi(1) or レポートログ.cgi(1)
$XYMONHOME/bin/ のスクリプト

レポートを生成するときに xymongen コマンドライン オプションを使用できます。たとえば、特定のレポートを除外することができます。
レポートからのテストの種類 (例: "--ignorecolumns=msgs")。テストの名前を指定します。
レポートに含めるべきではないトレンド列と情報列、またはレポートの書式を設定するための列
異なります (例: "--subpagecolumns=2")。 特定のオプションを使用したい場合は、
レポートは Web インターフェイスから生成されるため、これらのオプションを
XYMONGENREPOPTS 環境変数内の $XYMONHOME/etc/xymonserver.cfg ファイル。

xymongen によって生成されたレポート ファイルは、個別のディレクトリに保存されます (各ディレクトリに XNUMX つ)。
report) $XYMONHOME/www/rep/ ディレクトリの下にあります。 これらは自動的にクリーンアップされるはずです
- 新しいレポートが生成されると、古いレポートは削除されます。

インストール後、レポートを生成してみてください。 おそらく、次のリンクが表示されます。
左上隅 (ack.html、nongreen.html など) が機能しなくなりました。 これらを修正するには、次のように変更します
$XYMONHOME/web/repnormal_header ファイルなので、これらのリンクは「&XYMONWEB」を参照していませんが、
Xymon ページの通常の URL プレフィックスに追加します。

SLA 報告

xymongen レポートにより、真の SLA (サービス レベル アグリーメント) の生成が可能になります。
24 時間 7 日ではないサービス期間についてもレポートが作成されます。 これは、
ホストがサービス期間を定義するための「REPORTTIME:timespec」タグ、およびオプションで
「WARNPCT:level」タグは、合意された可用性を定義します。

注：を参照してください ホスト.cfg(5) これらのオプションの正確な構文については、「」を参照してください。

「REPORTTIME:timespec」は、サービスが稼働していると予想される時刻を指定します。
ランニング。 デフォルトでは、これは 24 日 XNUMX 時間、すべての曜日です。 SLA がカバーする範囲のみの場合
月曜から金曜の午前 7 時から午後 8 時まで、これを「REPORTTIME=W:0700:2000」と定義すると、レポート ジェネレーターが
次に、通常の 24 時間 7 日の可用性だけでなく、「SLA 可用性」も計算します。
SLA 期間中のホストのステータスのみが考慮されます。

DOWNTIME:timespec パラメータは、SLA 可用性の計算に影響します。 停電した場合
「ダウンタイム」の可能性があると定義された時間中に発生した場合、障害は次のメッセージで報告されます。
「青」の状態。 (「無効」にし、Xymon を使用してホストする場合も同じ色が使用されます)
「無効化」機能）。 テストステータスが「青」の時間はSLAに含まれません。
ホストがダウンしているとみなされる時間や、
レポートがカバーする合計時間。 したがって、「青色」時間は事実上無視されます。
SLA 可用性計算により、システムに影響を与えることなく計画的なダウンタイムを実現できます。
SLA の可用性を報告しました。

例: ホストは再起動されたため、「DOWNTIME:*:0700:0730 REPORTTIME=W:0600:2200」になります。
毎日午前 7 時から午前 7.30 時 6 分までですが、サービスは午前 10 時から午後 XNUMX 時まで利用できる必要があります。 ために
レポートの日、午前 7 時 10 分から午前 7 時 15 分 (計画された再起動) までダウンしていましたが、
午後9時53分から午後10時15分まで。 したがって、その日のイベントは次のとおりです。

0700 : 10分間(600秒)緑色
0710 : 青 5分間(300秒)
0715 : 14時間38分(52680秒)緑色
2153 : 22分間(1320秒)赤
2215 : グリーン

サービスは 600+52680 = 53280 秒間利用できます。 420秒間ダウン（赤）します
(21:53からSLA期間が終了する22:00までの時間)。 に含まれる合計時間は、
レポートは、青色の 15 分間 = 7 秒を除く 10 時間 (午前 5 時から午後 53700 時) です。 つまり、SLA
可用性は 53280/53700 = 99,22%

可用性を設定するための「WARNPCT:level」タグが hosts.cfg ファイルでサポートされています。
ホストごとにしきい値を設定します。 このしきい値は、テストが次のように報告されるかどうかを決定します。
レポートでは緑、黄、または赤で表示されます。 デフォルト値は、via を使用してすべてのホストに設定できます。
XYMONREPWARN 環境変数ですが、このタグによってオーバーライドされます。 レベルは次のように与えられます
パーセンテージ、例: "WARNPCT:98.5"

事前に生成された レポート

通常、xymongen は、動的に生成された Web ページにリンクするレポートを生成します。
テストの詳細なステータス (reportlog.sh CGI スクリプト経由)。

これらの動的リンクなしで xymongen にレポートを生成させることも可能です。
レポートは別のサーバーにエクスポートできます。 を事前に生成しておくと便利な場合があります。
複数のユーザーに同じレポートを生成させることで負荷を軽減します。

これを行うには、時間を選択するために「--reportopts」オプションを指定して xymongen を実行する必要があります。
レポートが対象とする間隔、レポートのスタイル (クリティカル、非グリーン、またはすべてのイベント)、
そして動的ページを生成しないように要求します。

構文は次のとおりです。

xymongen --reportopts=開始時刻:終了時刻:nodynamic:style

「starttime」と「endtime」は Unix の time_t 値、つまり 1 月 XNUMX 日からの秒数として指定されます。
1970 年 00:00 GMT。 幸いなことに、これは、次の場合に GNU 日付ユーティリティを使用して簡単に計算できます。
「+%s」出力オプションを使用してください。 GNU 日付ユーティリティをお持ちでない場合は、それを入手してください
www.gnu.org から。 または、同じ目的で「etime」ユーティリティを使用することもできます。
www.deadcat.net のアーカイブから入手できます。

"nodynamic" は 0 (動的ページの場合、デフォルト) または 1 (動的ページなし、つまり事前
生成される、ページ)。

「style」は、「crit」（クリティカル、つまり赤のイベントのみを含む）、「nongr」（すべてのイベントを含む）のいずれかです。
緑色以外のイベント）、または「すべて」（すべてのイベントを含む）。

他の xymongen オプションも使用できます。たとえば、特定の項目を除外する場合は「--ignorecolumns」です。
レポートからのテスト。

通常は、XYMONWEB 環境変数も指定する必要があります (環境変数は一致する必要があります)。
レポートにアクセスできるようにするベース URL)、および出力ディレクトリ
レポート ファイルが保存される場所。 XYMONWEB を指定する場合は、おそらく次のことも行う必要があります。
XYMONHELPSKIN および XYMONNOTESSKIN 環境変数を定義します。 これらは次のことを指しているはずです
Xymon のヘルプ ファイルとメモ ファイルが存在する URL。 定義されていない場合、
ヘルプ ファイルとノート ファイルへのリンクはレポート ディレクトリ内を指し、おそらく
動作しません。

したがって、静的レポートに対する xymongen の一般的な呼び出しは次のようになります。

START=`日付 +%s --date="22 年 2003 月 00 日 00:00:XNUMX"`
END=`日付 +%s --date="22 年 2003 月 23 日 59:59:XNUMX"`
XYMONWEB=/reports/bigbrother/daily/2003/06/22 \
XYMONHELPSKIN=/xymon/help \
XYMONNOTESSKIN=/xymon/notes \
xymongen --reportopts=$START:$END:1:crit \
--subpagecolumns=2 \
/var/www/docroot/reports/xymon/daily/2003/06/22

「XYMONWEB」設定は、レポートが次の URL で利用可能になることを意味します。
"http://www.server.com/reports/xymon/daily/2003/06/22」。レポートには内部情報が含まれています
この URL を使用するリンクがあるため、別の場所に簡単に移動することはできません。

最後のパラメータは、Web サーバー上の対応する物理ディレクトリであり、
ザイモンウェブのURL。 もちろん、レポート ファイルは好きな場所に作成できます。
別のマシン - その後、それらを Web サーバーに移動します。

どのように date(1) ユーティリティは、開始時間パラメータと終了時間パラメータを計算するために使用されます。

ENVIRONMENT 変数

ボードフィルター
フィルタリングによって、Web ページに含まれるホスト/テストを選択するために使用されるフィルタ
xymond vi xymondboard コマンドから取得したデータ。 見る キシモン(1) 詳細については
フィルター構文について。 デフォルトでは、フィルタリングは行われません。

onworks.net サービスを使用してオンラインで xymongen を使用する