Documentation

Zabbixマニュアル

1 インストールと最初のステップ

Zabbix 8.0へのアップグレードに関する注意事項

Zabbix 8.0.x のアップグレードノート

テンプレートの変更

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

2 クイックスタートガイド

基本設定

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

2 新しいホスト

3 新しいアイテム

4 新しいトリガー

5 問題通知の受信

6 新しいテンプレート

Apache Webサーバーの監視

Linuxサーバーの監視

MySQLサーバーの監視

3 インストール: 追加ガイド

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

MSIからのWindowsエージェントのインストール

PKGからのmacOSエージェントのインストール

WindowsでのZabbix agent 2のビルド

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

コンテナからのインストール

ソースからのインストール

パッケージからのインストールに関する注意

4 アップグレード

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

Debian/Ubuntu

Red Hat Enterprise Linux

アップグレードの問題

コンテナからのアップグレード

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

既知の問題

要件

2 Zabbix 8.0の新機能

Zabbix 8.0.x の新機能

3 Zabbixアプライアンス

4 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サービス

5 設定

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

1 ホストウィザード

2 ホストの設定

3 ホストグループの設定

4 インベントリ

5 一括更新

1 アイテムの作成

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

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

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

1 保存前処理のテスト

2 保存前処理の詳細

3 保存前処理の例

4 JSONPath機能

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

5 JavaScriptの保存前処理

1 追加のJavaScriptオブジェクト

2 ブラウザアイテムのJavaScriptオブジェクト

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

3 アイテムのタイプ

1 Zabbix エージェント

1 Zabbixエージェント2

2 Windows Zabbixエージェント

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 監視

15 依存アイテム

16 HTTPエージェント

17 Prometheus チェック

18 スクリプト

19 ブラウザアイテム

4 ヒストリとトレンド

5 ユーザーパラメーター

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

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

7 一括アップデート

8 値のマッピング

9 キュー

10 バリューキャッシュ

11 即時実行

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

1 トリガーの設定

2 トリガー条件式

3 トリガーの依存関係

4 トリガーの深刻度

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

6 一括アップデート

7 予測トリガー関数

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

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

3 問題の手動クローズ

5 イベント相関

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

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

7 視覚化

1 グラフ

1 シンプルグラフ

2 カスタムグラフ

3 アドホックグラフ

4 グラフの集計

2 ネットワークマップ

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

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

3 リンクインジケーター

3 ダッシュボード

8 テンプレートとテンプレートグループ

1 テンプレートの設定

2 テンプレートグループの設定

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

4 ネスト

5 一括アップデート

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

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

2 Zabbix agent 2 テンプレートの運用

3 HTTPテンプレートの操作

4 IPMI テンプレートの操作

5 JMX テンプレートの運用

6 ODBC テンプレートの操作

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

8 VMwareテンプレートの操作

10 イベント時の通知

1 メディアタイプ

1 E-mail

1 自動化されたGmail/Office365メディアタイプ

2 SMS

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

4 Webhook

1 Webhookスクリプトの例

2 アクション

1 アクション

2 実行内容

1 メッセージの送信

2 リモートコマンド

3 追加操作

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

3 復旧時実行

4 更新時実行

5 エスカレーション

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

1 マクロ関数

2 ユーザーマクロ

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

4 Secretユーザーマクロ

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

6 式マクロ

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

1 ユーザの設定

2 ユーザー権限

3 ユーザグループ

13 secrets の保存

1 CyberArkの設定

2 HashiCorpの設定

14 スケジュールレポート

15 データのエクスポート

1 ファイルにエクスポート

2 外部システムへのストリーミング

3 SNMPゲートウェイ

6 サービス監視

1 サービストリー

2 SLA

3 セットアップ例

1 Web監視アイテム

2 実際のシナリオ

8 仮想マシンの監視

1 VMware監視アイテムキー

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

3 VMwareアイテムのJSONの例

4 VMware監視設定例

9 メンテナンス

10 正規表現

11 問題の認識

1 障害の抑制

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

1 テンプレートグループ

2 ホストグループ

3 テンプレート

4 ホスト

5 ネットワークマップ

6 メディアタイプ

13 ディスカバリ

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

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

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

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

1 アイテムプロトタイプ

2 トリガープロトタイプ

3 グラフのプロトタイプ

4 ホストプロトタイプ

5 ディスカバリのプロトタイプ

6 ローレベルディスカバリに関する注意点

7 ディスカバリールール

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

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

3 CPUとCPUコアの検出

4 SNMP OIDsの検出

5 SNMP OIDsの検出 (legacy)

6 JMXオブジェクトの検出

7 IPMIセンサーの検出

8 systemdサービスの検出

9 Windowsサービスの検出

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

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

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

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

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

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

8 カスタムLLDルール

14 分散監視

1 監視設定の同期

2 プロキシの負荷分散と高可用性

1 証明書の利用

2 事前共有鍵の使用

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

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

2 証明書の問題

3 PSKの問題

16 Webインターフェース

1 イベントメニュー

2 ホストメニュー

3 アイテムメニュー

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

1 ダッシュボード

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

2 ダッシュボードウィジェットのパラメータ

1 アクションログ

2 時計

3 ディスカバリーステータス

4 お気に入りグラフ

5 お気に入りのマップ

6 ゲージ

7 Geomap

8 グラフ

9 グラフ（クラシック）

10 グラフのプロトタイプ

11 ハニカム

12 ホスト稼働状況

13 ホストカード

14 ホストナビゲーター

15 アイテムカード

16 アイテム履歴

17 アイテムナビゲーター

18 アイテム値

19 マップ

20 マップナビゲーションツリー

21 円グラフ

22 問題のあるホスト

23 問題

24 問題の深刻度別

25 散布図

26 SLAレポート

27 システム情報

28 トップホスト

29 トップアイテム

30 トップトリガー

31 トリガーの概要

32 URL

33 Web監視

2 監視データ

1 障害

1 原因と症状の障害

2 ホスト

1 グラフ

2 ホストダッシュボード

3 Webシナリオ

3 最新データ

4 マップ

5 ディスカバリ

3 サービス

1 サービス

2 SLA

3 SLAレポート

4 インベントリ

1 概要

2 ホスト

5 レポート

1 システム情報

2 定期レポート

3 稼働レポート

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

5 監査ログ

6 アクションログ

7 通知レポート

6 データ収集

1 テンプレートグループ

2 ホストグループ

3 テンプレート

1 アイテム

2 トリガー

3 グラフ

4 ディスカバリルール

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

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

3 グラフのプロトタイプ

4 ホストのプロトタイプ

5 ディスカバリのプロトタイプ

5 Webシナリオ

4 ホスト

1 アイテム

2 トリガー

3 グラフ

4 ディスカバリルール

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

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

3 グラフのプロトタイプ

4 ホストのプロトタイプ

5 ディスカバリのプロトタイプ

5 Webシナリオ

5 メンテナンス

6 イベント相関関係

7 ディスカバリ

7 アラート

1 アクション

2 メディアタイプ

3 スクリプト

8 ユーザー

1 ユーザーグループ

2 ユーザーの役割

3 ユーザー

4 APIトークン

5 認証

1 HTTP

2 LDAP

3 SAML

4 MFA

9 管理

1 一般設定

2 監査ログ

3 ハウスキーピング

4 プロキシ

5 プロキシグループ

6 マクロ

7 キュー

3 ユーザー設定

1 グローバル通知

2 ブラウザのサウンド

4 グローバル検索

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

6 ページパラメーター

7 定義

8 独自テーマ作成

9 デバッグモード

10 Zabbix用Cookie

11 タイムゾーン

12 パスワードのリセット

13 時間帯とホストセレクター

17 ベストプラクティス

1 セキュリティのベストプラクティス

1 アクセス制御

1 MySQL/MariaDBのセキュリティ保護

2 PostgreSQL/TimescaleDBのセキュリティ保護

2 暗号化

3 Webサーバー

2 設定のベストプラクティス

18 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

Connector

Connectorオブジェクト

connector.create

connector.delete

connector.get

connector.update

Correlation

Correlationオブジェクト

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard

Dashboardオブジェクト

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

Dashboard widget fields

1 Action log

2 Clock

3 Discovery status

4 Favorite graphs

5 Favorite maps

6 Gauge

7 Geomap

8 Graph

9 Graph (classic)

10 Graph prototype

11 Honeycomb

12 Host availability

13 Host card

14 Host navigator

15 アイテムカード

16 アイテムの履歴

17 アイテムナビゲーター

18 アイテム値

19 マップ

20 マップナビゲーションツリー

21 パイチャート

22 問題のあるホスト

23 問題

24 問題の深刻度別

25 散布図

26 SLAレポート

27 システム情報

28 トップホスト

29 トップアイテム

30のトップトリガー

31 トリガーの概要

32 URL

33 Web監視

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

history.push

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.propagate

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.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

LLDルールプロトタイプ

LLDルールプロトタイプオブジェクト

discoveryruleprototype.create

discoveryruleprototype.delete

discoveryruleprototype.get

discoveryruleprototype.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

MFA

MFAオブジェクト

mfa.create

mfa.delete

mfa.get

mfa.update

Module

Moduleオブジェクト

module.create

module.delete

module.get

module.update

Problem

Problemオブジェクト

problem.get

Proxy

Proxyオブジェクト

proxy.create

proxy.delete

proxy.get

proxy.update

Proxy group

Proxy groupオブジェクト

proxygroup.create

proxygroup.delete

proxygroup.get

proxygroup.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.getscriptsbyevents

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.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

Template group

Template groupオブジェクト

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

Token

Tokenオブジェクト

token.create

token.delete

token.generate

token.get

token.update

Trend

Trendオブジェクト

trend.get

Trigger

Triggerオブジェクト

trigger.create

trigger.delete

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.provision

user.resettotp

user.unblock

user.update

User directory

User directoryオブジェクト

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

User group

User groupオブジェクト

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

Value map

Value mapオブジェクト

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

Web scenario

Web scenarioオブジェクト

httptest.create

httptest.delete

httptest.get

httptest.update

ユーザーマクロ

User macroオブジェクト

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

付録1. 参考文献の解説

付録2. 7.4から8.0への変更点

付録3. 8.0の変更点

19 拡張機能

1 ローダブルモジュール

2 プラグイン

3 フロントエンドモジュール

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

1 データベースの作成

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

3 プライマリキーへのデータベースのアップグレード

4 監査ログテーブルのパーティション化の準備

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

1 MySQLの暗号化設定

2 PostgreSQLの暗号化設定

6 フロントエンドへのセキュアな接続

7 TimescaleDBのセットアップ

8 Elasticsearchのセットアップ

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

10 rootとしてエージェントを実行する

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

12 Microsoft Entra ID での SAML 設定

13 OktaによるSAMLのセットアップ

14 OneLoginでのSAML設定

15 定期レポートの設定

16 追加のフロントエンド言語

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 NVIDIA GPUプラグイン

11 Oracleプラグイン

12 PostgreSQLプラグイン

13 Redisプラグイン

14 SMARTプラグイン

8 Zabbix Java ゲートウェイ

9 Zabbix Webサービス

10 環境変数

11 インクルード

3 プロトコル

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

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

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

5 Zabbix senderプロトコル

6 ヘッダー

7 改行区切りJSONエクスポートプロトコル

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

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

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

4 戻り値のエンコード

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

6 センサー

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

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

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

10 proc.getパラメーター

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

12 Zabbix統計のリモート監視

13 Zabbixを使用したKerberosの設定

14 modbus.getパラメーター

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

16 system.sw.packages.getの戻り値

17 net.dns.getの戻り値

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

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

1 集計関数

1 Foreach 関数

2 ビット演算関数

3 日付と時刻の関数

4 ヒストリ関数

5 トレンド関数

6 数学関数

7 演算子関数

8 予測関数

9 文字列関数

6 マクロ

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

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

8 日時フォーマット

9 コマンドの実行

10 バージョン間の互換性

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

13 Zabbix APIのPythonライブラリ

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

15 その他の問題

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

17 エスケープの例

21 クイックリファレンスガイド

1 ZabbixエージェントでLinuxを監視する

2 ZabbixエージェントでWindowsを監視する

3 HTTP経由でApacheを監視する

4 Zabbixエージェント2でMySQLを監視する

5 ZabbixでVMwareを監視する

6 Zabbixでネットワークトラフィックを監視する

7 アクティブチェックを使用してネットワークトラフィックを監視する

8 ブラウザアイテムでウェブサイトの監視

9 Zabbixエージェント2(パッシブ)でWebサイトの証明書を監視する

10 Zabbixでネットワークスイッチやルーターを監視する

11 アクティブチェックを使用してWindowsイベントログを監視する

1 Zabbix CloudでZabbixをデプロイする

2 ノードの設定

3 ユーザーの追加

4 Zabbix Cloudとオンプレミスの主な違い

デベロッパーセンター

モジュール

モジュールファイルの構造

manifest.json

アクション

ビュー

アセット

新しいモジュールの登録

ウィジェット

設定

プレゼンテーション

チュートリアル

モジュールの作成 (チュートリアル)

ウィジェットの作成 (チュートリアル)

例

プラグイン

例

プラグインの作成(チュートリアル)

プラグインインターフェース

拡張機能開発の変更点

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

zabbix_web_service

Table of Contents

17 ベストプラクティス
- 概要

17 ベストプラクティス

概要

このセクションでは、Zabbixを設定するためのベストプラクティスについて説明します。

これらのプラクティスはZabbixの動作に必須ではありませんが、最適で安全な使用エクスペリエンスを実現するために実装することを強くお勧めします。