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

ソースからコンパイルすることで、Zabbixの最新バージョンを入手できます。 Zabbixのソースコードの取得も参照してください。

ソースからZabbixをインストールする手順を、こちらで詳しく説明します。

Zabbixデーモンのインストール

1 ソースアーカイブをダウンロードする

Zabbixのダウンロードページに移動し、ソースアーカイブをダウンロードします。 ダウンロードしたら、次のコマンドを実行してソースを展開します。

tar -zxvf zabbix-8.2.0.tar.gz

コマンドには正しいZabbixバージョンを指定してください。 ダウンロードしたアーカイブの名前と一致している必要があります。

2 ユーザーアカウントの作成

すべての Zabbix デーモンプロセスは、権限のないシステムユーザーで実行されます。 Zabbix デーモンを権限のないユーザーアカウントから起動した場合、そのユーザーとして実行され続けます。

デフォルト設定では、デーモンを root として起動すると、zabbix ユーザーアカウントに切り替わります。このアカウントはあらかじめ存在している必要があります。 zabbix システムユーザーおよびグループを作成するには、以下のコマンドを実行します。

RedHatベースのシステム:

groupadd --system zabbix
useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix

Debianベースのシステム:

addgroup --system --quiet zabbix
adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix

Zabbix Webインターフェース用に別のユーザーアカウントを作成する必要はありません。

セキュリティに関する推奨事項

Zabbix サーバーとエージェントを同じマシン上で実行する場合は、別々のユーザーアカウントで実行することを推奨します。 両方を同じユーザーとして実行すると、エージェントがサーバーの設定ファイルにアクセスできるため、Zabbix の Admin レベルのユーザーにデータベースパスワードなどの機密情報が公開される可能性があります。

Zabbix を root、bin、または特別な権限を持つその他のアカウントとして実行することは、セキュリティリスクとなります。

ホームディレクトリ(オプション)

Zabbix プロセスにホームディレクトリは必要ないため、通常は作成しないことを推奨します。 ただし、ホームディレクトリを必要とする機能(たとえば、MySQL の認証情報を $HOME/.my.cnf に保存する機能)が必要な場合は、以下のコマンドを使用して作成できます。

RedHatベースのシステムでは、以下を実行します。

mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix
chown zabbix:zabbix /usr/lib/zabbix

Debianベースのシステムでは、以下を実行します。

mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix
chown zabbix:zabbix /var/lib/zabbix
3 Zabbixデータベースの作成

Zabbix サーバーおよびプロキシデーモン、ならびにZabbix Webインターフェースには、データベースが必要です。 Zabbix エージェントの実行には必要ありません。

データベーススキーマの作成とデータセットの挿入用に、SQL スクリプトが提供されています。 Zabbixプロキシのデータベースにはスキーマのみが必要ですが、Zabbixサーバーのデータベースにはスキーマに加えてデータセットも必要です。

Zabbixデータベースを作成したら、Zabbixのコンパイルに関する次の手順に進んでください。

4 ソースを設定する

Zabbix サーバー、Zabbix プロキシ、または Zabbix エージェントをビルドするには、GNU拡張を含むC99が必要です。 このバージョンは、CFLAGS="-std=gnu99" を設定して明示的に指定できます。

export CFLAGS="-std=gnu99"

Zabbix Gitリポジトリからインストールする場合は、最初に次のコマンドを実行する必要があります。

./bootstrap.sh

Zabbix サーバーまたはプロキシのソースを設定する場合は、使用するデータベースタイプを指定する必要があります。 サーバーまたはプロキシのプロセスでコンパイルできるデータベースタイプは、一度に1つだけです。

サポートされている設定オプションをすべて表示するには、展開したZabbixソースディレクトリ内で次のコマンドを実行します。

./configure --help

Zabbix サーバーおよびエージェントのソースを設定するには、次のようなコマンドを実行します。

./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares

Zabbix サーバー(PostgreSQLなどを使用)のソースを設定するには、次のようなコマンドを実行します。

./configure --enable-server --with-postgresql --with-net-snmp

Zabbix プロキシ(SQLiteなどを使用)のソースを設定するには、次のようなコマンドを実行します。

./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2

Zabbix エージェントのソースを設定するには、次のコマンドを実行します。

./configure --enable-agent

または、Zabbix エージェント2の場合は次のコマンドを実行します。

./configure --enable-agent2

Zabbix エージェント2をビルドするには、サポート対象のGoバージョンをインストールする必要があります。

コンパイルオプションに関する注意事項:

  • --enable-agent - Zabbix エージェントに加えて、Zabbix getおよびZabbix senderのコマンドラインユーティリティをコンパイルします。
  • --with-libcurl - 仮想マシン監視、SMTP認証、web.page.* Zabbix エージェントのアイテム、およびテレメトリクエリアイテムに必要です。 要件(libcurl)も参照してください。
  • --with-libxml2 - 仮想マシン監視に必要です。
  • --with-libpcre2[=DIR] - Zabbixは常にPCRE2ライブラリを使用してコンパイルされます。このオプションでは、カスタムPCRE2インストールパスのみを指定できます。
  • --with-mysql=/path/to/mysql_config - 特定のMySQLクライアントライブラリ設定へのパスを指定します。 MySQLまたはMariaDBの複数のバージョンがインストールされている場合に便利です。
  • --enable-static - ライブラリを静的にリンクします(Solarisではサポートされていません)。 必要なライブラリがないシステムにコンパイル済みバイナリを配布する予定がある場合に使用します。 Zabbix サーバーのビルド時には推奨されません。 サーバーを静的にビルドするには、すべての外部ライブラリの静的バージョンが必要です。 configureスクリプトは、これを自動的には確認しません。
  • --with-stacksize=<value> - スレッドごとのスタックサイズをキロバイト単位で設定します(例: --with-stacksize=512)。 スタックオーバーフローが原因でZabbixがクラッシュまたはフリーズする場合(デフォルトのスレッドスタック制限が低いシステムでの前処理中など)は、この値を増やすことができます。
  • --with-apm(--enable-proxyとの組み合わせでのみ使用) - Zabbix プロキシでアプリケーションパフォーマンス監視(APM)を使用するために必要です。 要件(g++、gRPC、protobuf、Abseil)も参照してください。

ライブラリが見つからないなどの理由で ./configure が失敗した場合は、詳細なエラー情報を確認するために config.log ファイルを確認してください。

たとえば、libssl が見つからない場合、直ちに表示されるエラーメッセージは誤解を招く可能性があります。

checking for main in -lmysqlclient... no
configure: error: Not found mysqlclient library

この場合、config.log に実際の原因が示されます。

/usr/bin/ld: cannot find -lssl
/usr/bin/ld: cannot find -lcrypto

以下も参照してください。

5 すべてをビルドしてインストールする

Zabbix Gitリポジトリからインストールする場合は、最初に次のコマンドを実行する必要があります。

$ make dbschema

make install

この手順は、十分な権限を持つユーザー(通常は「root」)として、または sudo を使用して実行してください。

make install を実行すると、デフォルトではデーモンバイナリ(zabbix_server、zabbix_agentd、zabbix_proxy)が /usr/local/sbin に、クライアントバイナリ(zabbix_get、zabbix_sender)が /usr/local/bin にインストールされます。

/usr/local 以外の場所を指定するには、ソースを設定する前の手順で --prefix キーを使用します。たとえば、--prefix=/home/zabbix のように指定します。 この場合、デーモンバイナリは <prefix>/sbin に、ユーティリティは <prefix>/bin にインストールされます。 マニュアルページは <prefix>/share にインストールされます。

6 設定ファイルの確認と編集

zabbix_agentd がインストールされているすべてのホストで、このファイルを設定する必要があります。

ファイル内で、Zabbix サーバーの IP アドレス を指定する必要があります。 他のホストからの接続は拒否されます。

データベース名、ユーザー、パスワード(使用する場合)を指定する必要があります。

小規模なインストール(監視対象ホストが10台以下)の場合は、その他のパラメータはデフォルト値のままで問題ありません。 ただし、Zabbix サーバー(またはプロキシ)のパフォーマンスを最大限に高めたい場合は、デフォルトのパラメータを変更してください。

サーバーの IP アドレスとプロキシのホスト名(サーバーが認識できる名前)、およびデータベース名、ユーザー、パスワード(使用する場合)を指定する必要があります。

SQLite を使用する場合は、データベースファイルの完全なパスを指定する必要があります。DB ユーザーとパスワードは必要ありません。

7 デーモンを起動する

サーバー側で zabbix_server を実行します。

zabbix_server

システムで36MB(またはそれ以上)の共有メモリを割り当てられることを確認してください。割り当てられない場合、サーバーが起動せず、サーバーのログファイルに「Cannot allocate shared memory for <type of cache>.」と表示されます。 これはFreeBSDやSolaris 8で発生する可能性があります。

監視対象のすべてのマシンで zabbix_agentd を実行します。

zabbix_agentd

システムで2MBの共有メモリを割り当てられることを確認してください。割り当てられない場合、エージェントが起動せず、エージェントのログファイルに「Cannot allocate shared memory for collector.」と表示されます。 これはSolaris 8で発生する可能性があります。

Zabbixプロキシをインストールしている場合は、zabbix_proxy を実行します。

zabbix_proxy

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

PHPファイルのコピー

ZabbixのWebインターフェースはPHPで記述されているため、PHPをサポートするWebサーバーが必要です。 インストールは、uiディレクトリのPHPファイルをWebサーバーのHTMLドキュメントディレクトリにコピーするだけで完了します。

Apache WebサーバーのHTMLドキュメントディレクトリの一般的な場所は次のとおりです。

  • /usr/local/apache2/htdocs(ソースからApacheをインストールした場合のデフォルトディレクトリ)
  • /srv/www/htdocs(OpenSUSE、SLES)
  • /var/www/html(Debian、Ubuntu、Fedora、RHEL)

HTMLルートの代わりにサブディレクトリを使用することを推奨します。 サブディレクトリを作成し、ZabbixのWebインターフェースファイルをそこにコピーするには、<htdocs>を実際のディレクトリに置き換えて、次のコマンドを実行します。

mkdir <htdocs>/zabbix
cd ui
cp -a . <htdocs>/zabbix

英語以外の言語を使用する場合は、手順について追加のWebインターフェース言語のインストールを参照してください。

フロントエンドのインストール

Zabbixフロントエンドのインストールウィザードについては、Webインターフェースのインストールページを参照してください。

Zabbixエージェント2のロード可能プラグインのインストール

Zabbixエージェント2のロード可能プラグインのインストールは、組み込みプラグインでは対応していないターゲット(MongoDBサーバーまたはクラスター、PostgreSQLおよびそのフォークなど)を監視する場合にのみ必要です。
ロード可能プラグインと組み込みプラグインの一覧を参照してください。

プラグインをインストールする前に、そのREADMEファイルを確認してください。
特定の要件やインストール手順が記載されている場合があります。

ソースからインストールするには、まずロード可能プラグインのソースアーカイブをダウンロードして展開します。

プラグインをコンパイルするには、展開したプラグインのディレクトリに移動し、makeを実行します。

make

Zabbixエージェント2のロード可能プラグインをビルドするには、サポートされているGoのバージョンをインストールする必要があります。

プラグインの実行ファイルは、Zabbixエージェント2からロードできる限り、どこに配置してもかまいません。
プラグイン設定ファイルでプラグインバイナリへのパスを指定します。たとえば、PostgreSQLプラグインの場合はpostgresql.confで指定します。

Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql

プラグイン設定ファイルへのパスは、Zabbixエージェント2の設定ファイルのIncludeパラメータで指定する必要があります。

Include=/path/to/plugin/configuration/file/postgresql.conf

プラグインの設定について詳しくは、セットアップを参照してください。

Zabbixが提供するロード可能プラグインでは、次のビルドターゲットを持つシンプルなmakefileを使用します。

  • make - プラグインをビルドします
  • make clean - プラグインのビルドによって作成されたすべてのファイルを削除します
  • make check - 自己テストを実行します(実際の監視対象(PostgreSQLデータベースなど)が必要です)
  • make style - golangci-lintでGoコードのスタイルをチェックします
  • make format - go fmtでGoコードをフォーマットします
  • make dist - すべての依存関係を含むソースアーカイブを作成します

Javaゲートウェイのインストール

JMXアプリケーションを監視する場合にのみ、Javaゲートウェイをインストールする必要があります。 Javaゲートウェイは軽量で、データベースを必要としません。

ソースからインストールするには、まずソースアーカイブをダウンロードして展開します。

Javaゲートウェイをコンパイルするには、--enable-javaオプションを指定して./configureスクリプトを実行します。 デフォルトの/usr/local以外のインストール先を指定するために、--prefixオプションを指定することを推奨します。Javaゲートウェイをインストールすると、単一の実行可能ファイルだけでなく、ディレクトリツリー全体が作成されるためです。

./configure --enable-java --prefix=$PREFIX

JavaゲートウェイをコンパイルしてJARファイルにパッケージ化するには、makeを実行します。 この手順では、javacおよびjarの実行可能ファイルがパスに含まれている必要があります。

make

これで、src/zabbix_java/binにzabbix-java-gateway-$VERSION.jarファイルが作成されます。 ディストリビューションディレクトリのsrc/zabbix_javaからJavaゲートウェイを実行しても問題ない場合は、Javaゲートウェイの設定と実行の手順に進むことができます。 それ以外の場合は、十分な権限があることを確認してmake installを実行します。

make install

Javaゲートウェイの設定と実行について詳しくは、セットアップに進んでください。

Zabbix Webサービスのインストール

Zabbix Webサービスのインストールは、スケジュールレポートを使用する場合にのみ必要です。

ソースからインストールするには、まずソースアーカイブをダウンロードして展開します。

Zabbix Webサービスをコンパイルするには、--enable-webserviceオプションを指定して./configureスクリプトを実行します。

Zabbix Webサービスをビルドするには、サポートされているGoのバージョンをインストールする必要があります。

Webサービスをインストールしたマシンでzabbix_web_serviceを実行します。

zabbix_web_service

スケジュールレポートの生成を設定する方法については、セットアップに進んでください。

Zabbix MCPサーバーのインストール

ソースからインストールするには、まずソースアーカイブをダウンロードして展開します。

Zabbix MCPサーバーをコンパイルするには、MCPサーバーのソースディレクトリで次のコマンドを実行します。

make build

Zabbix MCPサーバーをビルドするには、サポートされているGoのバージョンをインストールする必要があります。

zabbix_mcp_server -Vの出力およびZabbix APIリクエストのUser-Agentで特定のバージョンを報告するには、VERSION変数を設定します。例: make build VERSION=8.2.0

バイナリを/usr/local/sbinに、サンプル設定ファイルを/etc/zabbixにインストールするには、次を実行します。

sudo make install

設定ファイル/etc/zabbix/zabbix_mcp_server.confを編集し、少なくとも次のパラメータを設定します。

  • FrontendURL - api_jsonrpc.phpで終わるZabbix APIのURL。
  • AllowedIP - 接続を許可するMCPクライアントのアドレス。

MCPクライアントからの接続を暗号化するには、TLSAccept=certを設定してTLSCertFileおよびTLSKeyFileを指定するか、TLSを処理する信頼できるリバースプロキシの背後でMCPサーバーを実行します。

zabbixユーザーが存在しない場合(たとえば、マシンにMCPサーバーのみがインストールされている場合)は、ユーザーアカウントの作成の説明に従って作成します。

設定ファイルを検証し、zabbix_mcp_serverを起動します。

zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf -T
zabbix_mcp_server -c /etc/zabbix/zabbix_mcp_server.conf

サーバーの設定およびMCPクライアントの接続について詳しくは、MCPサーバーを参照してください。

Zabbixソースコードの取得

Zabbixソースコードを取得するには、いくつかの方法があります。

  • 公式Zabbix Webサイトから、リリース済みの安定バージョンをダウンロードできます
  • 公式Zabbix Webサイトの開発者ページから、ナイトリービルドをダウンロードできます
  • Gitソースコードリポジトリシステムから、最新の開発バージョンを取得できます:

リポジトリをクローンするには、Gitクライアントをインストールする必要があります。 公式のコマンドラインGitクライアントパッケージは、ディストリビューションでは一般的に git と呼ばれています。 たとえば、Debian/Ubuntuにインストールするには、次のコマンドを実行します:

sudo apt-get update
sudo apt-get install git

すべてのZabbixソースを取得するには、コードを配置するディレクトリに移動し、次のコマンドを実行します:

git clone https://git.zabbix.com/scm/zbx/zabbix.git

コンパイルに関する問題

Zabbixをソースからコンパイルする際の既知の問題は次のとおりです。 その他のケースについては、既知の問題ページを参照してください。

標準以外の場所にあるライブラリ

Zabbixでは、標準以外の場所にあるライブラリを指定できます。 次の例では、Zabbixは指定された標準以外の場所から curl-config を実行し、その出力を使用して適切なlibcurlを判断します。

$ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config

システムにインストールされているlibcurlがこれだけであれば動作しますが、標準の場所に別のlibcurlがインストールされている場合(例えば、パッケージマネージャーによってインストールされている場合)は、動作しない可能性があります。 これは、Zabbixには新しいバージョンのライブラリが必要で、他のアプリケーションには古いバージョンが必要な場合に発生します。

したがって、同じコンポーネントが標準の場所にも存在する場合、標準以外の場所にあるコンポーネントを指定しても、常に機能するとは限りません。

例えば、libcurlパッケージがインストールされたままの状態で /usr/local にインストールされた新しいlibcurlを使用すると、Zabbixが誤ったライブラリを選択し、コンパイルに失敗する可能性があります。

usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8':
/tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header'
collect2: error: ld returned 1 exit status

ここでは、関数 curl_easy_header() は古い /usr/lib/x86_64-linux-gnu/libcurl.so では使用できませんが、新しい /usr/local/lib/libcurl.so では使用できます。

問題はリンカーのフラグの順序にあり、解決策の1つは、LDFLAGS変数にライブラリへのフルパスを指定することです。

$ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config

一部のシステムでは -Wl,--no-as-needed オプションが必要になる場合があることに注意してください(Debianベースのシステムにおけるデフォルトのリンクオプションも参照してください)。

一部のシステムでスタックサイズが小さすぎる

スタックオーバーフローが原因で Zabbix がクラッシュまたはフリーズする場合は、ソースを設定する際に --with-stacksize オプションを使用して、スレッドごとのスタックサイズを増やすことができます。
この問題は、特に複数のスレッドが作成される 前処理 中に、デフォルトのスレッドスタック制限が低いシステムで発生することがあります。

次の例では、スレッドごとのスタックサイズを 512 KB に設定しています。

./configure --enable-server --with-mysql --with-stacksize=512

Linux ベースのシステムでは、ulimit -s コマンドを使用して、実行時にシステムのスレッドスタック制限を確認できます。