Zabbixマニュアル

1. はじめに

1 マニュアルの構成

3 Zabbixの機能

4 Zabbixの概要

5 Zabbix 6.4.0 の新機能

6 Zabbix 6.4.1 の新機能

7 Zabbix 6.4.2 の新機能

8 Zabbix 6.4.3 の新機能

9 Zabbix 6.4.4 の新機能

10 Zabbix 6.4.5 の新機能

11 Zabbix 6.4.6 の新機能

12 Zabbix 6.4.7 の新機能

13 Zabbix 6.4.8 の新機能

14 What's new in Zabbix 6.4.9

15 What's new in Zabbix 6.4.10

16 What's new in Zabbix 6.4.11

17 What's new in Zabbix 6.4.12

18 What's new in Zabbix 6.4.13

19 What's new in Zabbix 6.4.14

2 定義

3. Zabbixのプロセス

1 Zabbixサーバー

1 高可用性(HA)

2 Zabbixエージェント

3 Zabbixエージェント2

4 Proxy

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 PostgreSQLプラグインの依存関係

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

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

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

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

Windows版Zabbix agent 2の構築

Windows版Zabbix agentの構築

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

1 Red Hat Enterprise Linux

2 Debian/Ubuntu/Raspbian

3 SUSE Linux Enterprise Server

4 MSIファイルによるWindows用agentのインストール

6 PKG から Mac OS エージェントのインストール

6 不安定版リリース

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

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

7 アップグレード手順

パッケージでアップグレード

1 Red Hat Enterprise Linux

2 Debian/Ubuntu

Upgrade from containers

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

8 既知の問題点

1 Compilation issues

9 テンプレート変更点

10 Upgrade notes for 6.4.0

11 Upgrade notes for 6.4.1

12 Upgrade notes for 6.4.2

13 Upgrade notes for 6.4.3

13 Upgrade notes for 6.4.4

14 Upgrade notes for 6.4.5

15 Upgrade notes for 6.4.6

17 Upgrade notes for 6.4.7

18 Upgrade notes for 6.4.8

19 Upgrade notes for 6.4.9

20 Upgrade notes for 6.4.10

21 Upgrade notes for 6.4.11

22 Upgrade notes for 6.4.12

23 Upgrade notes for 6.4.13

24 Upgrade notes for 6.4.14

5. クイックスタート

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

2 新規ホスト

3 新規アイテム

5 障害発生の通知

6 新規テンプレート

6. Zabbixアプライアンス

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

1 ホストの設定

2 インベントリ

3 一括アップデート

1 アイテムの作成

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

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

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

1 使用例

2 プリプロセッシングの詳細

3 JSONPath機能

JSONPath における LLD マクロ値からの特殊文字のエスケープ

4 JavaScript のプリプロセッシング

追加のJavaScriptオブジェクト

5 CSVからJSONへのプリプロセス

3 アイテムのタイプ

1 Zabbix エージェント

Windows-specific item keys

Zabbix agent 2

2 SNMP agent

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

2 特殊なOID

3 MIB ファイル

3 SNMP trap

4 IPMIチェック

5 シンプルチェック

VMware監視アイテムキー

6 Log file monitoring

7 計算 item

集計計算

8 内部チェック

9 SSH チェック

10 Telnet チェック

11 外部からのチェック

12 Trapper item

13 JMX 監視

14 ODBC 監視

1 MySQL の推奨 UnixODBC 設定

2 PostgreSQLの推奨UnixODBC設定

3 Oracle の推奨 UnixODBC 設定

4 MSSQL の推奨 UnixODBC 設定

15 依存アイテム

16 HTTP agent

17 Prometheus チェック

18 スクリプト item

4 ヒストリとトレンド

5 ユーザパラメータ

Zabbix agent の機能拡張

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

8 一括アップデート

9 値のマッピング

10 キュー

10 バリューキャッシュ

12 即時実行

13 agent チェックの制限

1 トリガーの設定

2 トリガー条件式

3 トリガーの依存関係

4 トリガーの深刻度

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

6 一括アップデート

7 予兆 trigger 関数

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

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

3 問題の手動クローズ

5 イベント相関

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

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

7 視覚化

1 グラフ

1 シンプルグラフ

2 カスタムグラフ

3 アドホックグラフ

4 グラフの集計

2 Network maps

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

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

3 リンクインジケーター

3 ダッシュボード

4 ホストダッシュボード

8 テンプレート

1 テンプレートの設定

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

3 ネストする

4 一括更新

9 すぐに使えるテンプレート(Templates out of the box)

HTTP template operation

IPMIテンプレートの操作

JMXテンプレートの操作

ODBC テンプレート操作

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

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

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

10 イベント時の通知

1 メディアタイプ

1 E-mail

2 SMS

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

4 Webhook

Webhook スクリプトの例

2 Actions

1 アクション

2 実行内容

1 メッセージの送信

2 リモートコマンド

3 追加操作

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

3 復旧時実行

4 更新時実行

5 エスカレーション

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

1 マクロ関数

2 Secret user macros

2 ユーザーマクロ

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

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

5 式マクロ

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

1 ユーザの設定

2 ユーザー権限

3 ユーザグループ

13 secrets の保存

CyberArk configuration

HashiCorp configuration

14 スケジュールレポート

1 Export to files

2 Streaming to external systems

8. サービス監視

1 サービスツリー

3 SLA

4 セットアップ例

1 Web監視アイテム

2 シナリオの実例

10. 仮想マシン監視

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

4 VMware monitoring setup example

JSON examples for VMware items

VMware監視アイテムキー

11. メンテナンス

12. 正規表現

13. 障害イベントの確認

1. Problem suppression

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

1 Template groups

3 テンプレート

3 ホスト

4 ネットワークマップ

5 メディアタイプ

15. ディスカバリ

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

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

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

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

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

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

3 グラフのプロトタイプ

4 ホストのプロトタイプ

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

5 ディスカバリルール

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

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

3 CPUとCPUコアの検出

4 Discovery of SNMP OIDs

4 SNMP OIDsの検出

5 JMXオブジェクトの検出

6 IPMIセンサーの検出

7 systemdサービスの検出

8 Windowsサービスの検出

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

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

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

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

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

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

16 分散監視

1 Synchronization of monitoring configuration

1 証明書の利用

2 事前共有鍵の使用

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

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

2 証明書の問題

3 PSK problems

18 Webインターフェース

1 Event menu

1 Host menu

3 Item context menu

2 フロントエンドセクション

1 Dashboards

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

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

1 監視データ

2 障害

1 Cause and symptom problems

3 ホスト

1 グラフ

2 Web シナリオ

4 最新データ

5 Maps

6 ディスカバリ

2 サービス

1 Services

3 SLA

4 SLAレポート

3 インベントリ

1 ホストインベントリの概要

2 ホスト

4 レポート

1 システム情報

2 定期レポート

3 稼働レポート

4 障害発生数上位100項目

5 Audit log

6 アクションログ

7 通知レポート

6 Data collection

1 Template groups

1 ホストグループ

2 テンプレート

1 Items

2 トリガー

3 グラフ

4 ディスカバリルール

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

4 ホストのプロトタイプ

5 Webシナリオ

3 ホスト

1 Items

2 トリガー

3 グラフ

4 ディスカバリルール

1 Item prototypes

2 Trigger prototypes

3 Graph prototypes

4 ホストのプロトタイプ

5 Webシナリオ

5 Maintenance

6 Event correlation

7 Discovery

6 管理

1 一般設定

2 Audit log

2 プロキシ

3 Housekeeping

5 Macros

9 キュー

7 Alerts

5 アクション

7 メディアタイプ

8 スクリプト

8 Users

3 Users

4 API tokens

4 ユーザーグループ

5 Authentication

1 HTTP

2 LDAP

3 SAML

5 ユーザーの役割

3 ユーザー設定

1 グローバル通知

2 ブラウザのサウンド

4 グローバルサーチ

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

6 ページパラメーター

7 定義

8 独自テーマ作成

9 デバッグモード

10 Zabbix用Cookie

11 タイムゾーン

13 Resetting password

19. API

メソッドリファレンス

Action

> Action object

action.create

action.delete

action.get

action.update

Alert

> Alert object

alert.get

API info

apiinfo.version

Audit log

> Audit log object

auditlog.get

Authentication

> Authentication object

authentication.get

authentication.update

Autoregistration

> Autoregistration object

autoregistration.get

autoregistration.update

Configuration

configuration.export

configuration.import

configuration.importcompare

Connector

> Connector object

connector.create

connector.delete

connector.get

connector.update

Correlation

> Correlation object

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard

> Dashboard object

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 object

dhost.get

Discovered service

> Discovered service object

dservice.get

Discovery check

> Discovery check object

dcheck.get

Discovery rule

> Discovery rule object

drule.create

drule.delete

drule.get

drule.update

Event

> Event object

event.acknowledge

event.get

Graph

> Graph object

graph.create

graph.delete

graph.get

graph.update

Graph item

> Graph item object

graphitem.get

Graph prototype

> Graph prototype object

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

High availability node

> High availability node object

hanode.get

History

> History object

history.clear

history.get

Host

> Host object

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Host group

> Host group object

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.propagate

hostgroup.update

Host interface

> Host interface object

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Host prototype

> Host prototype object

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Housekeeping

> Housekeeping object

housekeeping.get

housekeeping.update

Icon map

> Icon map object

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

Image

> Image object

image.create

image.delete

image.get

image.update

Item

> Item object

item.create

item.delete

item.get

item.update

Item prototype

> Item prototype object

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

LLD rule

> LLD rule object

discoveryrule.copy

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Maintenance

> Maintenance object

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Map

> Map object

map.create

map.delete

map.get

map.update

Media type

> Media type object

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Module

> Module object

module.create

module.delete

module.get

module.update

Problem

> Problem object

problem.get

Proxy

> Proxy object

proxy.create

proxy.delete

proxy.get

proxy.update

Regular expression

> Regular expression object

regexp.create

regexp.delete

regexp.get

regexp.update

Report

> Report object

report.create

report.delete

report.get

report.update

Role

> Role object

role.create

role.delete

role.get

role.update

Script

> Script object

script.create

script.delete

script.execute

script.get

script.getscriptsbyevents

script.getscriptsbyhosts

script.update

Service

> Service object

service.create

service.delete

service.get

service.update

Settings

Settings

settings.get

settings.update

SLA

> SLA object

sla.create

sla.delete

sla.get

sla.getsli

sla.update

Task

> Task object

task.create

task.get

Template

> Template object

template.create

template.delete

template.get

template.massadd

template.massremove

template.massupdate

template.update

Template dashboard

> Template dashboard object

templatedashboard.create

templatedashboard.delete

templatedashboard.get

templatedashboard.update

Template group

> Template group object

templategroup.create

templategroup.delete

templategroup.get

templategroup.massadd

templategroup.massremove

templategroup.massupdate

templategroup.propagate

templategroup.update

Token

> Token object

token.create

token.delete

token.generate

token.get

token.update

Trend

> Trend object

trend.get

Trigger

> Trigger object

trigger.create

trigger.delete

trigger.get

trigger.update

Trigger prototype

> Trigger prototype object

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

User

> User object

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.provision

user.unblock

user.update

User directory

> User directory object

userdirectory.create

userdirectory.delete

userdirectory.get

userdirectory.test

userdirectory.update

User group

> User group object

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

User macro

> User macro object

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

Value map

> Value map object

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

Web scenario

> Web scenario object

httptest.create

httptest.delete

httptest.get

httptest.update

6.4 での Zabbix API 変更内容

付録 1. 参考文献の解説

付録 2. 6.2 から 6.4 への変更点

20 拡張機能

2 Plugins

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

3 Frontend modules

6 ローダブルモジュール

1 FAQ / トラブルシューティング

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

1 データベースの作成

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

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

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

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

5 TimescaleDBのセットアップ

6 Elasticsearch のセットアップ

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

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

10 MicrosoftWindows上のZabbixエージェント

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

11 SAML setup with Microsoft Azure AD

12 オラクルデータベースセットアップ

13 SAML setup with OneLogin

13 レポートスケジュールの設定

14 フロントエンドへの言語追加

15 Upgrading to numeric values of extended range

3 プロセスの設定

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

4 Modbus プラグイン

5 MongoDB プラグイン

6 MQTT プラグイン

7 MSSQL plugin

7 MySQL plugin

8 オラクルプラグイン

9 PostgreSQL plugin

10 Redisプラグイン

11 スマートプラグイン

8 Zabbix Java ゲートウェイ

9 Zabbix Webサービス

10 インクルード

4 プロトコル

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

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

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

4 Zabbix agent 2 plugin protocol

5 Zabbix sender プロトコル

6 ヘッダー

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

2 vm.memory.size parameters

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

4 Trapper items

5 Minimum permission level for Windows agent items

6 Encoding of returned values

7 Large file support

8 Sensor

9 Notes on memtype parameter in proc.mem items

10 Notes on selecting processes in proc.mem and proc.num items

11 Implementation details of net.tcp.service and net.udp.service checks

11 proc.get parameters

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

13 Zabbix統計のリモートモニタリング

14 Zabbixを使用したKerberosの設定

15 modbus.getパラメーター

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

17 Return values

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

1 集計関数

1 Foreach 関数

2 Bitwise functions

3 日時関数

4 ヒストリ関数

5 Mathematical functions

5 Trend functions

6 Operator functions

7 Prediction functions

8 String functions

7 マクロ

1 Supported macros

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

8 単位と記号

9 日時フォーマット

10 コマンドの実行

11 バージョン間の互換性

12 データベースエラーハンドリング

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

14 Python library for Zabbix API

14 サービスモニタリングのアップグレード

15 その他の問題

16 Agent と agent 2 の比較

18 Escaping examples

22. Quick reference guides

1. Monitor Linux with Zabbix agent

2 Monitor Windows with Zabbix agent

3. Monitor Apache via HTTP

4. Monitor MySQL with Zabbix agent 2

5 Monitor VMware with Zabbix

デベロッパーセンター

Modules

Module file structure

manifest.json

Actions

Views

Assets

Register a new module

Widgets

Configuration

Presentation

Tutorials

Create a module (tutorial)

Create a widget (tutorial)

例

プラグイン

Examples

Build a plugin (tutorial)

Plugin interfaces

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

zabbix_web_service

Table of Contents

Value map

Value map

このクラスでは、バリューマップを操作できます。

オブジェクトリファレンス:

Value map

利用可能なメソッド:

valuemap.create - 新しいバリューマップの作成
valuemap.delete - バリューマップの削除
valuemap.get - バリューマップの取得
valuemap.update - バリューマップの更新