Zabbixマニュアル

1. はじめに

1 マニュアルの構成

3 Zabbixの機能

4 Zabbixの概要

5 Zabbix 6.0.0の新機能

6 Zabbix 6.0.1の新機能

7 Zabbix 6.0.2の新機能

8 Zabbix 6.0.3の新機能

9 Zabbix 6.0.4の新機能

10 Zabbix 6.0.5の新機能

11 Zabbix 6.0.6の新機能

12 Zabbix 6.0.7の新機能

13 Zabbix 6.0.8の新機能

14 Zabbix 6.0.9の新機能

15 Zabbix 6.0.10の新機能

16 Zabbix 6.0.11の新機能

17 Zabbix 6.0.12の新機能

18 Zabbix 6.0.13の新機能

19 Zabbix 6.0.14の新機能

20 Zabbix 6.0.15の新機能

21 Zabbix 6.0.16の新機能

22 Zabbix 6.0.17の新機能

23 Zabbix 6.0.18の新機能

24 Zabbix 6.0.19の新機能

25 Zabbix 6.0.20の新機能

26 Zabbix 6.0.21の新機能

27 Zabbix 6.0.22の新機能

28 Zabbix 6.0.23の新機能

29 Zabbix 6.0.24の新機能

30 Zabbix 6.0.25の新機能

31 Zabbix 6.0.26の新機能

32 Zabbix 6.0.27の新機能

33 Zabbix 6.0.28の新機能

34 Zabbix 6.0.29の新機能

35 Zabbix 6.0.30の新機能

36 Zabbix 6.0.31の新機能

37 Zabbix 6.0.32の新機能

38 Zabbix 6.0.33の新機能

39 Zabbix 6.0.34の新機能

40 Zabbix 6.0.35の新機能

41 Zabbix 6.0.36の新機能

42 Zabbix 6.0.37の新機能

43 Zabbix 6.0.38の新機能

44 Zabbix 6.0.39の新機能

45 Zabbix 6.0.40の新機能

46 What's new in Zabbix 6.0.41

3. Zabbixのプロセス

1 Zabbixサーバー

1 高可用性(HA)

2 Zabbixエージェント

3 Zabbixエージェント2

4 Zabbixプロキシ

5 Zabbix Javaゲートウェイ

1 ソースからのセットアップ

2 RHELパッケージでのセットアップ

3 Debian/Ubuntuパッケージでのセットアップ

6 zabbix_senderコマンド

7 zabbix_getコマンド

8 zabbix_jsコマンド

9 Zabbix Webサービス

4. インストール

1 Zabbixの入手

2 要件

1 プラグイン

1 PostgreSQLプラグインの依存関係

2 MongoDBプラグインの依存関係

2 安全なZabbixセットアップのベストプラクティス

3 ソースコードからのインストール

1 WindowsでのZabbixエージェントのビルド

2 WindowsでのZabbixエージェント2のビルド

3 macOSでのZabbixエージェントのビルド

4 パッケージインストール

1 Red Hat Enterprise Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux Enterprise Server

4 MSIでWindowsエージェントのインストール

5 PKGでMacOSエージェントのインストール

6 不安定版リリース

5 コンテナでのインストール

OpenShiftでのインストール

6 Webインターフェースのインストール

1 Debian/UbuntuのWebインターフェースのインストール

7 アップグレード手順

1 ソースからのアップグレード

2 パッケージからのアップグレード

1 Red Hat Enterprise Linux

2 Debian/Ubuntu

8 既知の問題

1 コンパイルの問題

9 テンプレートの変更点

10 6.0.0へアップグレード時の注意点

11 6.0.1へアップグレード時の注意点

12 6.0.2へアップグレード時の注意点

13 6.0.3へアップグレード時の注意点

14 6.0.4へアップグレード時の注意点

15 6.0.5へアップグレード時の注意点

16 6.0.6へアップグレード時の注意点

17 6.0.7へアップグレード時の注意点

18 6.0.8へアップグレード時の注意点

19 6.0.9へアップグレード時の注意点

20 6.0.10へアップグレード時の注意点

21 6.0.11へアップグレード時の注意点

22 6.0.12へアップグレード時の注意点

23 6.0.13へアップグレード時の注意点

24 6.0.14へアップグレード時の注意点

25 6.0.15へアップグレード時の注意点

26 6.0.16へアップグレード時の注意点

27 6.0.17へアップグレード時の注意点

28 6.0.18へアップグレード時の注意点

29 6.0.19へアップグレード時の注意点

30 6.0.20へアップグレード時の注意点

31 6.0.21へアップグレード時の注意点

32 6.0.22へアップグレード時の注意点

33 6.0.23へアップグレード時の注意点

34 6.0.24へアップグレード時の注意点

35 6.0.25へアップグレード時の注意点

36 6.0.26へアップグレード時の注意点

37 6.0.27へアップグレード時の注意点

38 6.0.28へアップグレード時の注意点

39 6.0.29へアップグレード時の注意点

40 6.0.30へアップグレード時の注意点

41 6.0.31へアップグレード時の注意点

42 6.0.32へアップグレード時の注意点

43 6.0.33へアップグレード時の注意点

44 6.0.34へアップグレード時の注意点

45 6.0.35へアップグレード時の注意点

46 6.0.36へアップグレード時の注意点

47 6.0.37へアップグレード時の注意点

48 6.0.38へアップグレード時の注意点

49 6.0.39へアップグレード時の注意点

50 Upgrade notes for 6.0.40

5. クイックスタート

1 ログインとユーザー設定

2 新規ホスト

3 新規アイテム

4 新規トリガー

5 障害発生の通知

6 新規テンプレート

6. Zabbixアプライアンス

1 ホストとホストグループ

1 ホストの設定

2 ホストグループの設定

3 インベントリ

4 一括更新

1 アイテムの作成

1 アイテムキーのフォーマット

2 監視間隔のカスタマイズ

2 アイテムの値の保存前処理

1 使用例

2 保存前処理の詳細

3 JSONPath機能

1 JSONPathのLLDマクロ値からの特殊文字のエスケープ

4 JavaScriptの保存前処理

1 追加のJavaScriptオブジェクト

5 CSVからJSONへの保存前処理

3 アイテムのタイプ

1 Zabbix エージェント

1 Zabbixエージェント2固有のアイテムキー

2 Windows固有のアイテムキー

2 SNMPエージェント

1 ダイナミックインデックス

2 特殊なOID

3 MIB ファイル

3 SNMPトラップ

4 IPMIチェック

5 シンプルチェック

1 VMware監視アイテムキー

6 ログファイル監視

7 計算アイテム

1 集計計算

8 内部チェック

9 SSH チェック

10 Telnetチェック

11 外部チェック

12 トラッパーアイテム

13 JMX 監視

14 ODBC 監視

1 MySQLの推奨UnixODBC設定

2 PostgreSQLの推奨UnixODBC設定

3 Oracleの推奨UnixODBC設定

4 MSSQLの推奨UnixODBC設定

15 依存アイテム

16 HTTPエージェント

17 Prometheus チェック

18 スクリプト

4 ヒストリとトレンド

5 ユーザーパラメータ

1 Zabbixエージェントの機能拡張

6 ローダブルモジュール

7 Windows パフォーマンスカウンタ

8 一括アップデート

9 値のマッピング

10 キュー

11 Value キャッシュ

12 監視データ取得

13 エージェントチェックの制限

14 プラグイン

1 ローダブルプラグインのビルド

1 トリガーの設定

2 トリガー条件式

3 トリガーの依存関係

4 トリガーの深刻度

5 トリガーの深刻度のカスタマイズ

6 一括アップデート

7 予測トリガー関数

1 トリガーイベントの生成

2 その他のイベントソース

3 障害の手動クローズ

5 イベント相関

1 トリガーによるイベント相関

2 グローバルイベント相関

7 視覚化

1 グラフ

1 シンプルグラフ

2 カスタムグラフ

3 アドホックグラフ

4 グラフの集計

2 ネットワークマップ

1 ネットワークマップの設定

2 ホストグループの構成要素

3 リンクインジケーター

3 ダッシュボード

4 ホストダッシュボード

8 テンプレート

1 テンプレートの設定

2 リンク作成/リンク削除

3 ネスト

4 一括アップデート

9 すぐに使えるテンプレート

1 Zabbixエージェントテンプレートの操作

2 Zabbixエージェント2テンプレートの操作

3 HTTPテンプレートの操作

4 IPMIテンプレートの操作

5 JMXテンプレートの操作

6 ODBCテンプレートの操作

7 ネットワークデバイス用の標準テンプレート

10 イベント時の通知

1 メディアタイプ

1 E-mail

2 SMS

3 カスタムアラートスクリプト

4 Webhook

1 Webhookスクリプトの例

2 アクション

1 アクション

2 実行内容

1 メッセージの送信

2 リモートコマンド

3 追加操作

4 メッセージでのマクロ使用

3 復旧時実行

4 更新時実行

5 エスカレーション

3 サポート対象外通知の受信

1 マクロ関数

2 ユーザーマクロ

3 コンテキストユーザーマクロ

4 ローレベルディスカバリマクロ

5 式マクロ

12 ユーザーとユーザーグループ

1 ユーザの設定

2 ユーザー権限

3 ユーザグループ

13 secrets の保存

14 定期レポート

8. サービス監視

1 サービスツリー

2 サービスアクション

3 SLA

4 セットアップ例

1 Web監視アイテム

2 シナリオの実例

10. 仮想マシン監視

1 仮想マシンディスカバリキーフィールド

11. メンテナンス

12. 正規表現

13. 障害イベントの確認

14. 設定のエクスポート/インポート

1 ホストグループ

2 テンプレート

3 ホスト

4 ネットワークマップ

5 メディアタイプ

15. ディスカバリ

1 ネットワークディスカバリ

1 ネットワークディスカバリルールの設定

2 アクティブエージェントの自動登録

3 ローレベルディスカバリ

1 アイテムのプロトタイプ

2 トリガーのプロトタイプ

3 グラフのプロトタイプ

4 ローレベルディスカバリにおける注意点

5 ディスカバリルール

1 ファイルシステムマウントの検出

2 ネットワークインターフェースの検出

3 CPUとCPUコアの検出

4 SNMP OIDsの検出

5 JMXオブジェクトの検出

6 IPMIセンサーの検出

7 systemdサービスの検出

8 Windowsサービスの検出

9 Windowsパフォーマンスカウンターインスタンスの検出

10 WMIクエリを使用した検出

11 ODBC SQLクエリを使用した検出

12 Prometheusデータを使用した検出

13 ブロックデバイスの検出

14 Zabbixでのホストインターフェース検出

6 カスタムLLDルール

16. 分散監視

1 証明書の利用

2 事前共有鍵の使用

3 トラブルシューティング

1 接続タイプまたは権限の問題

2 証明書の問題

3 PSKの問題

18. Webインターフェース

2 Webインターフェースセクション

1 監視データ

1 ダッシュボード

1 ダッシュボードウィジェット

1 アクションログ

2 時刻

3 データの概要

4 ディスカバリのステータス

5 お気に入りのグラフ

6 お気に入りのマップ

7 地理マップ

8 グラフ

9 グラフ（クラシック）

10 グラフのプロトタイプ

11 ホスト稼働状況

12 アイテムの値

13 マップ

14 マップナビゲーション

15 プレーンテキスト

16 障害中のホスト

17 障害

18 深刻度ごとの障害数

19 SLAレポート

20 システム情報

21 上位ホスト

22 トリガーの概要

23 URL

24 Web監視

2 障害

3 ホスト

1 グラフ

2 Webシナリオ

4 最新データ

5 マップ

6 ディスカバリ

2 サービス

1 サービス

2 サービスアクション

3 SLA

4 SLAレポート

3 インベントリ

1 概要

2 ホスト

4 レポート

1 システム情報

2 定期レポート

3 稼働レポート

4 障害発生数上位100トリガー

5 監査

6 アクションログ

7 通知レポート

5 設定

1 ホストグループ

2 テンプレート

1 アイテム

2 トリガー

3 グラフ

4 ディスカバリルール

1 アイテムのプロトタイプ

2 トリガーのプロトタイプ

3 グラフのプロトタイプ

4 ホストのプロトタイプ

5 Webシナリオ

3 ホスト

1 アイテム

2 トリガー

3 グラフ

4 ディスカバリルール

1 アイテムのプロトタイプ

2 トリガーのプロトタイプ

3 グラフのプロトタイプ

4 ホストのプロトタイプ

5 Web シナリオ

4 メンテナンス

5 Actions

6 イベント相関関係

7 ディスカバリ

6 管理

1 一般設定

2 プロキシ

3 認証

4 ユーザーグループ

5 ユーザーの役割

6 ユーザー

7 メディアタイプ

8 スクリプト

9 キュー

3 ユーザー設定

1 グローバル通知

2 ブラウザのサウンド

4 グローバルサーチ

5 フロントエンドメンテナンスモード

6 ページパラメーター

7 定義

8 独自テーマ作成

9 デバッグモード

10 Zabbix用Cookie

11 タイムゾーン

12 パスワードのリセット

19. API

メソッドリファレンス

Action

> Actionオブジェクト

action.create

action.delete

action.get

action.update

Alert

> Alertオブジェクト

alert.get

API info

apiinfo.version

Audit log

> Audit logオブジェクト

auditlog.get

Authentication

> Authenticationオブジェクト

authentication.get

authentication.update

Autoregistration

> Autoregistrationオブジェクト

autoregistration.get

autoregistration.update

Configuration

configuration.export

configuration.import

configuration.importcompare

Correlation

> Correlationオブジェクト

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard

> Dashboardオブジェクト

Dashboard widget fields

1 Action log

2 Clock

3 Data overview

4 Discovery status

5 Favorite graphs

6 Favorite maps

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Host availability

12 Item value

13 Map

14 Map navigation tree

15 Plain text

16 Problem hosts

17 Problems

18 Problems by severity

19 SLA report

20 System information

21 Top hosts

22 Trigger overview

23 URL

24 Web monitoring

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

Discovered host

> Discovered hostオブジェクト

dhost.get

Discovered service

> Discovered serviceオブジェクト

dservice.get

Discovery check

> Discovery checkオブジェクト

dcheck.get

Discovery rule

> Discovery ruleオブジェクト

drule.create

drule.delete

drule.get

drule.update

Event

> Eventオブジェクト

event.acknowledge

event.get

Graph

> Graphオブジェクト

graph.create

graph.delete

graph.get

graph.update

Graph item

> Graph itemオブジェクト

graphitem.get

Graph prototype

> Graph prototypeオブジェクト

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

High availability node

> High availability nodeオブジェクト

hanode.get

History

> Historyオブジェクト

history.clear

history.get

Host

> Hostオブジェクト

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Host group

> Host groupオブジェクト

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.update

Host interface

> Host interfaceオブジェクト

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Host prototype

> Host prototypeオブジェクト

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Housekeeping

> Housekeepingオブジェクト

housekeeping.get

housekeeping.update

Icon map

> Icon mapオブジェクト

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

Image

> Imageオブジェクト

image.create

image.delete

image.get

image.update

Item

> Itemオブジェクト

item.create

item.delete

item.get

item.update

Item prototype

> Item prototypeオブジェクト

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

LLD rule

> LLD ruleオブジェクト

discoveryrule.copy

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Maintenance

> Maintenanceオブジェクト

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Map

> Mapオブジェクト

map.create

map.delete

map.get

map.update

Media type

> Media typeオブジェクト

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Problem

> Problemオブジェクト

problem.get

Proxy

> Proxyオブジェクト

proxy.create

proxy.delete

proxy.get

proxy.update

Regular expression

> Regular expressionオブジェクト

regexp.create

regexp.delete

regexp.get

regexp.update

Report

> Reportオブジェクト

report.create

report.delete

report.get

report.update

Role

> Roleオブジェクト

role.create

role.delete

role.get

role.update

Script

> Scriptオブジェクト

script.create

script.delete

script.execute

script.get

script.getscriptsbyhosts

script.update

Service

> Serviceオブジェクト

service.create

service.delete

service.get

service.update

Settings

> Settingsオブジェクト

settings.get

settings.update

SLA

> SLAオブジェクト

sla.create

sla.delete

sla.get

sla.getsli

sla.update

Task

> Taskオブジェクト

task.create

task.get

Template

> Templateオブジェクト

template.create

template.delete

template.get

template.massadd

template.massremove

template.massupdate

template.update

Template dashboard

> Template dashboardオブジェクト

templatedashboard.create

templatedashboard.delete

templatedashboard.get

templatedashboard.update

Token

> Tokenオブジェクト

token.create

token.delete

token.generate

token.get

token.update

Trend

> Trendオブジェクト

trend.get

Trigger

> Triggerオブジェクト

trigger.adddependencies

trigger.create

trigger.delete

trigger.deletedependencies

trigger.get

trigger.update

Trigger prototype

> Trigger prototypeオブジェクト

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

User

> Userオブジェクト

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.unblock

user.update

User group

> User groupオブジェクト

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

User macro

> User macroオブジェクト

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

Value map

> Value mapオブジェクト

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

Web scenario

> Web scenarioオブジェクト

httptest.create

httptest.delete

httptest.get

httptest.update

Zabbix APIの6.0での変更点

付録1. 参考文献の解説

付録2. 5.4から6.0での変更点

20. モジュール

1 インストールとセットアップ

1 データベースの作成

2 Zabbixデータベースのキャラクターセットと照合の修正

3 データベースの主キーのアップグレード

4 データベースへの安全な接続

1 MySQLの暗号化設定

2 PostgreSQLの暗号化設定

5 TimescaleDBのセットアップ

6 Elasticsearchのセットアップ

7 イベント、アイテム値、トレンドのリアルタイムエクスポート

8 Zabbix用Nginxのセットアップに関するディストリビューション固有の注意事項

9 rootユーザーでのエージェントの実行

10 Microsoft Windows上のZabbixエージェント

11 Oktaを使用したSAMLセットアップ

11 SAML setup with Microsoft Entra ID

12 Oracleデータベースセットアップ

13 定期レポートの設定

14 Webインターフェースの言語追加

2 プロセスの設定

1 Zabbix サーバー

2 Zabbix プロキシ

3 Zabbix エージェント (UNIX)

4 Zabbix エージェント 2 (UNIX)

5 Zabbix エージェント (Windows)

6 Zabbix エージェント 2 (Windows)

7 Zabbix エージェント 2 プラグイン

1 Cephプラグイン

2 Dockerプラグイン

3 Ember+プラグイン

4 Memcachedプラグイン

5 Modbusプラグイン

6 MongoDBプラグイン

7 MQTTプラグイン

8 MSSQLプラグイン

9 MySQLプラグイン

10 Oracleプラグイン

11 PostgreSQLプラグイン

12 Redisプラグイン

13 Smartプラグイン

8 Zabbix Java ゲートウェイ

9 Zabbix Webサービス

10 インクルード

3 プロトコル

1 サーバープロキシデータ交換プロトコル

2 Zabbix エージェントのプロトコル

3 Zabbix エージェント 2 プロトコル

4 Zabbixエージェント2プラグインプロトコル

5 Zabbix sender プロトコル

6 ヘッダー

7 リアルタイムエクスポートプロトコル

1 各プラットフォームでサポートされているアイテム

2 vm.memory.size パラメーター

3 パッシブおよびアクティブエージェントチェック

4 トラッパーアイテム

5 Windowsエージェントアイテムの最小アクセス許可レベル

6 戻り値のエンコード

7 ラージファイルサポート

8 センサー

9 proc.memアイテムのmemtypeパラメーターに関する注意

10 proc.memおよびproc.numアイテムでのプロセスの選択に関する注意

11 net.tcp.serviceおよびnet.udp.serviceチェックの実装の詳細

12 到達不能/使用不可のホストインターフェース設定

13 Zabbix統計のリモート監視

14 Zabbixを使用したKerberosの設定

15 modbus.getパラメーター

16 VMwareのカスタムパフォーマンスカウンター名作成

17 Windowsのsystem.cpu.utilアイテムに関する注意事項

5 サポートされている関数

1 集計関数

1 Foreach 関数

2 Bitwise関数

3 日時関数

4 ヒストリ関数

5 トレンド関数

6 数学関数

7 オペレーター関数

8 予測関数

9 文字列関数

6 マクロ

1 サポートしているマクロ

2 ロケーションでサポートされているユーザーマクロ

8 日時フォーマット

9 コマンドの実行

10 バージョン間の互換性

11 データベースエラー処理

12 Windows用のZabbix senderダイナミックリンクライブラリ

13 Zabbix APIのPythonライブラリ

14 サービス監視のアップグレード

15 その他の問題

16 エージェントとエージェント2の比較

17 エスケープの例

Zabbixリファレンスマニュアル

zabbix_web_service

Table of Contents

1 プラグイン

1 プラグイン

サイドバーから、参照したい項目を選択してください。