1 ネットワークマップの設定
概要
Zabbixでマップを設定するには、まず一般的なパラメータを定義してマップを作成し、その後、実際のマップに要素とそのリンクを追加していきます。
マップには、ホスト、ホストグループ、トリガー、画像、または別のマップである要素を配置できます。
マップ要素を表すためにアイコンが使用されます。アイコンとともに表示する情報を定義できるほか、最近の障害が特別な方法で表示されるように設定することもできます。さらに、アイコン同士をリンクし、リンク上に表示する情報を定義できます。
アイコンをクリックしてアクセスできるカスタムURLを追加することもできます。これにより、ホストアイコンをホストのプロパティに、またはマップアイコンを別のマップにリンクできます。
マップ内の障害数は、原因障害についてのみ表示されます。
マップは Monitoring > Maps で管理され、ここで設定、管理、表示を行うことができます。監視ビューでは、アイコンをクリックして、いくつかのスクリプトやURLへのリンクを利用できます。
ネットワークマップはベクターグラフィックス（SVG）に基づいています。
パブリックマップとプライベートマップ
Zabbixのすべてのユーザー（非管理者ユーザーを含む）は、ネットワークマップを作成できます。 マップには所有者があり、作成したユーザーがその所有者となります。マップはパブリック またはプライベートにできます。
- パブリックマップはすべてのユーザーに表示されますが、表示するには、ユーザーが 少なくとも1つのマップ要素に対する読み取り権限を持っている必要があります。パブリックマップは、 ユーザー/ユーザーグループがこのマップに対する読み書き権限を持ち、かつ、リンク内のトリガーを含む 対応するマップのすべての要素に対して少なくとも読み取り権限を持っている場合に編集できます。
<!-- -->- プライベートマップは、その所有者と、所有者によって共有 されたユーザー/ユーザーグループにのみ表示されます。通常の（Super adminではない）ユーザーは、 自分が所属するグループと、それらのグループに所属するユーザーとのみ共有できます。Adminレベルのユーザーは、 所有者であるか共有ユーザーリストに含まれているかに関係なく、プライベートマップを表示できます。 プライベートマップは、マップの所有者が編集でき、また、ユーザー/ユーザーグループがこの マップに対する読み書き権限を持ち、かつ、リンク内のトリガーを含む対応するマップのすべての要素に対して 少なくとも読み取り権限を持っている場合にも編集できます。
ユーザーが読み取り権限を持たないマップ要素は、グレー表示のアイコンで表示され、 その要素上のすべてのテキスト情報は非表示になります。ただし、ユーザーがそのトリガーに対する 権限を持っていない場合でも、トリガーラベルは表示されます。
マップに要素を追加するには、ユーザーはその要素に対して少なくとも読み取り権限も持っている必要があります。
マップの作成
マップを作成するには、次の手順を実行します。
- Monitoring > Maps に移動する
- すべてのマップが表示されるビューに移動する
- Create map をクリックする
既存のマップの設定フォームにある Clone ボタンを使用して、新しいマップを作成することもできます。
このマップには、一般的なレイアウト属性を含む既存のマップのすべてのプロパティと、既存のマップの要素が引き継がれます。
Map タブには、一般的なマップ属性が含まれます。
必須入力フィールドには赤いアスタリスクが付いています。
一般的なマップ属性:
| Parameter | Description |
|---|---|
| Owner | マップ所有者の名前。 |
| Name | 一意のマップ名。 |
| Width | マップの幅（ピクセル）。 |
| Height | マップの高さ（ピクセル）。 |
| Background image | 背景画像の使用: No image - 背景画像なし（白い背景） Image - 背景画像として使用する画像を選択します。拡大縮小は行われません。地理的な地図やその他の画像を使用して、マップを見やすくできます。 |
| Automatic icon mapping | Administration → General → Icon mapping で設定された自動アイコンマッピングを使用するように設定できます。アイコンマッピングを使用すると、特定のアイコンを特定のホストインベントリフィールドに対応付けることができます。 |
| Icon highlight | このボックスをチェックすると、マップ要素が強調表示されます。 アクティブなトリガーを持つ要素には、最も重大度の高いトリガーと同じ色の丸い背景が表示されます。さらに、すべての障害が承認済みの場合は、円の周囲に太い緑色の線が表示されます。 "disabled" または "in maintenance" 状態の要素には、それぞれ灰色またはオレンジ色の四角い背景が付きます。 関連項目: マップの表示 |
| Mark elements on trigger status change | トリガー状態の最近の変更（最近の障害または復旧）は、要素アイコンのラベルがない3辺に、マーカー（内向きの赤い三角形）で強調表示されます。マーカーは30分間表示されます。 |
| Display problems | マップ要素で障害をどのように表示するかを選択します: Expand single problem - 障害が1件だけの場合は、障害名が表示されます。それ以外の場合は、障害の合計数が表示されます。 Number of problems - 障害の合計数が表示されます Number of problems and expand most critical one - 最も重大な障害の名前と障害の合計数が表示されます。 "Most critical" は、障害の深刻度に基づいて決定され、同じ場合は障害イベントIDに基づきます（IDが大きい、または後の障害が先に表示されます）。trigger map element では、障害の深刻度に基づき、同じ場合はトリガー一覧でのトリガーの位置に基づきます。同じトリガーに複数の障害がある場合は、最新のものが表示されます。 |
| Advanced labels | このボックスをチェックすると、要素タイプごとに個別のラベルタイプを定義できるようになります。 |
| Map element label type | マップ要素に使用するラベルタイプ: Label - マップ要素ラベル IP address - IPアドレス Element name - 要素名（たとえば、ホスト名） Status only - 状態のみ（OK または PROBLEM） Nothing - ラベルを表示しない |
| Map element label location | マップ要素に対するラベルの位置: Bottom - マップ要素の下 Left - 左側 Right - 右側 Top - マップ要素の上 |
| Problem display | 障害件数の表示方法: All - 障害の総数を表示します Separated - 未承認の障害件数を、障害総数とは別に数値で表示します Unacknowledged only - 未承認の障害件数のみを表示します |
| Minimum trigger severity | 選択した最小深刻度より低い障害は、マップに表示されません。 たとえば Warning を選択した場合、Information および Not classified レベルのトリガーによる変更はマップに反映されません。 |
| Show suppressed problems | このチェックボックスをオンにすると、ホストのメンテナンスのために通常は抑制される（表示されない）障害を表示します。 |
| URLs | 各要素タイプごとに、URL（最大2048文字）を定義できます。URLのラベルも定義できます。これらは、ユーザーがマップ表示モードで要素をクリックしたときにリンクとして表示されます。 マップURLの名前と値にはマクロを使用できます。完全な一覧については、サポートされるマクロ を参照し、'map URL names and values' を検索してください。 |
共有
共有タブには、マップのタイプと、プライベートマップの共有オプション （ユーザーグループ、ユーザー）が含まれます。
| パラメータ | 説明 |
|---|---|
| タイプ | マップのタイプを選択します。 プライベート - マップは選択したユーザーグループとユーザーにのみ表示されます パブリック - マップはすべてのユーザーに表示されます |
| ユーザーグループ共有のリスト | マップへのアクセスを許可するユーザーグループを選択します。 読み取り専用または読み書き可能のアクセスを許可できます。 |
| ユーザー共有のリスト | マップへのアクセスを許可するユーザーを選択します。 読み取り専用または読み書き可能のアクセスを許可できます。 |
このマップを保存するために 追加 をクリックすると、名前、サイズ、およびいくつかの設定を持つ空のマップが作成されます。次に、いくつかの要素を追加する必要があります。そのためには、マップ一覧で 編集 をクリックして編集可能な領域を開きます。
要素の追加
要素を追加するには、Map element の横にある Add をクリックします。新しい要素はマップの左上隅に表示されます。好きな場所へドラッグ＆ドロップしてください。
Grid オプションを "On" にすると、要素は常にグリッドに揃えられます（ドロップダウンからさまざまなグリッドサイズを選択でき、グリッドの表示/非表示も切り替えられます）。配置を揃えずに任意の場所へ要素を置きたい場合は、このオプションを "Off" にします。（後から Align map elements をクリックして、ランダムに配置した要素をグリッドに揃えることもできます。）
要素を配置できたら、名前を付けるなどして区別したくなるでしょう。要素をクリックするとフォームが表示され、要素タイプの設定、名前の指定、別のアイコンの選択などができます。
マップ要素の属性:
| Parameter | Description |
|---|---|
| Type | 要素のタイプ: Host - 選択したホストのすべてのトリガーの状態を表すアイコン Map - マップ内のすべての要素の状態を表すアイコン Trigger - 1つ以上のトリガーの状態を表すアイコン Host group - 選択したグループに属するすべてのホストのすべてのトリガーの状態を表すアイコン Image - いずれのリソースにも関連付けられていないアイコン |
| Label | アイコンのラベル。任意の文字列を指定できます。 マクロおよび複数行文字列を使用できます。 このフィールドでは式の macros がサポートされていますが、 avg、last、min、max 関数のみで、パラメータとして時間を指定する場合に限られます（例: {?avg(/host/key,1h)}）。サポートされるマクロの一覧は、supported macros を参照し、'map element labels' を検索してください。 |
| Label location | アイコンに対するラベルの位置: Default - マップの既定のラベル位置 Bottom - アイコンの下 Left - 左側 Right - 右側 Top - アイコンの上 |
| Host | 要素タイプが 'Host' の場合にホストを入力します。このフィールドはオートコンプリート対応で、ホスト名の入力を始めると一致するホストのドロップダウン候補が表示されます。スクロールして選択してください。選択を解除するには 'x' をクリックします。 |
| Map | 要素タイプが 'Map' の場合にマップを選択します。このフィールドはオートコンプリート対応で、マップ名の入力を始めると一致するマップのドロップダウン候補が表示されます。スクロールして選択してください。選択を解除するには 'x' をクリックします。 |
| Triggers | 要素タイプが 'Trigger' の場合、下の New triggers フィールドで1つ以上のトリガーを選択し、Add をクリックします。 選択したトリガーの順序は変更できますが、同じ深刻度のトリガー内でのみ可能です。複数トリガーの選択は、編集モードと表示モードの両方で {HOST.*} マクロの解決にも影響します。 編集モードでは、最初に表示される {HOST.*} マクロは、一覧の最初のトリガー（トリガーの深刻度に基づく）に応じて解決されます。 表示モードは、General map attributes の Display problems パラメータに依存します: - Expand single problem モードが選択されている場合、最初に表示される {HOST.*} マクロは、最新に検出された障害トリガー（深刻度は関係ありません）または、障害が検出されていない場合は一覧の最初のトリガーに応じて解決されます。 - Number of problems and expand most critical one モードが選択されている場合、最初に表示される {HOST.*} マクロは、トリガーの深刻度に応じて解決されます。 |
| Host group | 要素タイプが 'Host group' の場合にホストグループを入力します。このフィールドはオートコンプリート対応で、グループ名の入力を始めると一致するグループのドロップダウン候補が表示されます。スクロールして選択してください。選択を解除するには 'x' をクリックします。 |
| Tags | ウィジェットに表示する障害の数を制限するためのタグを指定します。特定のタグおよびタグ値を含めることも除外することもできます。複数の条件を設定できます。タグ名の一致は常に大文字小文字を区別します。 各条件には次の演算子があります: Exists - 指定したタグ名を含める Equals - 指定したタグ名と値を含める（大文字小文字を区別） Contains - タグ値に入力した文字列を含む指定タグ名を含める（部分一致、大文字小文字を区別しない） Does not exist - 指定したタグ名を除外する Does not equal - 指定したタグ名と値を除外する（大文字小文字を区別） Does not contain - タグ値に入力した文字列を含む指定タグ名を除外する（部分一致、大文字小文字を区別しない） 条件の計算タイプは2種類あります: And/Or - すべての条件を満たす必要があります。同じタグ名を持つ条件は Or 条件でグループ化されます Or - いずれか1つの条件を満たせば十分です このフィールドはホストおよびホストグループの要素タイプで使用できます。 |
| Automatic icon selection | この場合、どのアイコンを表示するかを決定するためにアイコンマッピングが使用されます。 |
| Icons | 通常、障害、メンテナンス、無効の各ケースで、要素に異なるアイコンを表示するよう選択できます。 |
| Coordinate X | マップ要素の X 座標。 |
| Coordinate Y | マップ要素の Y 座標。 |
| URLs | 要素固有の URL（最大 2048 文字）を要素に設定できます。URL のラベルも定義できます。これらは、ユーザーがマップ表示モードで要素をクリックしたときにリンクとして表示されます。要素に独自の URL があり、かつそのタイプに対するマップレベルの URL が定義されている場合、それらは同じメニューにまとめられます。 マップ要素名と値にはマクロを使用できます。完全な一覧は supported macros を参照し、'map URL names and values' を検索してください。 |
追加した要素は自動保存されません。ページから移動すると、すべての変更が失われる可能性があります。
そのため、右上隅の Update ボタンをクリックすることをおすすめします。クリックすると、その後のポップアップで何を選択しても変更は保存されます。
選択したグリッドオプションも各マップとともに保存されます。
要素の選択
要素を選択するには、1つを選択してから Ctrl を押しながら他の要素を選択します。
また、編集可能な領域で矩形をドラッグし、その中のすべての要素を選択することで、複数の要素を選択することができます。
複数の要素を選択すると、要素のプロパティフォームが一括更新モードに移行し、選択した要素の属性を一括して変更する
ことができます。そのためには、チェックボックスを使って属性をマークし、その属性に新しい値を入力します。
ここでマクロを使用することもできます(例えば、要素のラベルに {HOST.NAME} を使用)。
要素のリンク
要素をマップに配置したら、それらをリンクすることもできます。 2 つの要素をリンクするには、最初に２つの要素を選択した状態で、[リンク] の横にある [追加] をクリックします。
リンクが作成されると、単一要素フォームに追加の リンク セクションが含まれるようになります。 編集 をクリックして、リンク属性を編集します。
リンク属性:
| パラメータ | 説明 |
|---|---|
| ラベル | リンクの上に表示されるラベル。 このフィールドでは式 マクロがサポートされていますが、パラメータとして時間を指定した avg、last、min、max 関数のみがサポートされています (例: {?avg(/host/key) ,1h)}) |
| 接続方法 | リンクが接続する要素 |
| タイプ (正常OK) | デフォルトのリンク スタイル: Line - シングルライン Bold line - 太線 Dot - ドット Dashed line - 破線 |
| 色 (正常) | デフォルトのリンク色 |
| 障害発生時の条件設定 | リンクにリンクされたトリガーのリスト。 トリガーのステータスが 障害 の場合、そのスタイルがリンクに適用されます。 |
要素の移動とコピーペースト
選択した要素の1つをクリックし、マウスボタンを押したままカーソルを目的の場所に移動すると、選択した複数の要素を
マップ内の別の場所に 移動 することができます。
要素を選択し、マウスの右ボタンで選択した要素をクリックし、メニューから Copy を選択することで、1つまたは
複数の要素を コピー することができます。
要素を貼り付けるには、マウスの右ボタンで地図上の領域をクリックし、メニューから Paste を選択します。 Paste without external links を選択すると、選択した要素間のリンクのみを残して貼り付けられます。
コピー＆ペーストは、同じブラウザウィンドウ内で動作します。キーボードショートカットはサポートされていません。
図形の追加
マップ要素に加えて、いくつかの図形を追加することもできます。 図形はマップ要素ではなく、単なる視覚的な表現です。たとえば、 長方形の図形は、複数のホストをグループ化するための背景として使用できます。 追加できる図形は、長方形と楕円です。
図形を追加するには、Shape の横にある Add をクリックします。新しい図形は マップの左上隅に表示されます。ドラッグ＆ドロップで任意の場所に移動してください。
新しい図形はデフォルトの色で追加されます。図形をクリックするとフォームが表示され、 図形の見た目をカスタマイズしたり、テキストを追加したりできます。
図形を選択するには、1つ選択してから Ctrl キーを押したまま他の図形を選択します。 複数の図形を選択すると、要素の場合と同様に、共通のプロパティを一括更新できます。
図形内にはテキストを追加できます。テキストでは式
マクロがサポートされていますが、
使用できるのは avg、last、min、max 関数のみで、パラメータとして時間を指定する必要があります
（例: {?avg(/host/key,1h)}）。
テキストのみを表示するには、図形の枠線を削除して図形を見えなくできます （Border フィールドで「None」を選択します）。たとえば、上のスクリーンショットに表示されている {MAP.NAME} マクロは、実際にはテキスト付きの長方形の図形であり、マクロをクリックすると それが確認できます。
{MAP.NAME} は、マップの表示時に設定済みのマップ名に展開されます。
テキスト内でハイパーリンクを使用すると、マップの表示時にクリック可能になります。
図形内のテキストでは、行の折り返しは常に有効です。ただし、楕円内では、 楕円を長方形とみなした場合と同じように行が折り返されます。 単語の折り返しは実装されていないため、長い単語（図形内に収まらない単語）は折り返されず、 マップ編集ページではマスクされ、マップを含むその他のページでは切り取られます。
線の追加
図形だけでなく、線を追加することも可能です。線は、地図上の要素や図形をつなぐために使用します。
線を追加するには、図形の隣にある Add をクリックします。新しい図形がマップの左上隅に表示されます。それを選択し、
編集フォームの Line をクリックして、図形を線に変更します。次に、線の種類、幅、色など、線のプロパティを調整します。
図形と線の順序
ある図形を別の図形の前面に表示する（またはその逆にする）には、図形をマウスの右ボタンでクリックして、マップ図形メニューを表示します。
