差分

このページの2つのバージョン間の差分を表示します。

--- ja:documentation:05_big_environments:07_server_management [2022/01/30 05:20] – [データベース管理] junichi
+++ ja:documentation:05_big_environments:07_server_management [2022/12/09 08:43] – [NG 753 およびそれ以前のバージョンにおけるヒストリデータベース] junichi
@@ 行 526: / 行 526: @@
 ==== ヒストリデータベース ====
+{{  :wiki:pfms-databases-sql.png?nolink&  }}
 {{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}A **history database** is a database where old module data is transferred to make the main Pandora FMS database more responsive for everyday operations. That data will still be available for Pandora FMS console when viewing reports, module charts etc.
@@ 行 531: / 行 533: @@
 {{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}ヒストリデータベースは、メインの Pandora FMS データベースの応答を良くするために、そこから古いモジュールデータを移動させ保存しておくためのものです。データは、レポートやモジュールグラフの参照時に Pandora FMS コンソールでシームレスに利用できます。
-=== ヒストリデータベースの作成 ===
+=== ヒストリデータベースの設定 ===
-{{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}To configure a historical database, it is necessary to have a new server where to host it (different from the one of the main database). Once you have that server where MySQL is installed, follow these steps:
+<WRAP center round info 75%>
+Version NG 754 and later versions{{:wiki:icono-modulo-enterprise.png?23x23|Enterprise version}}.
+</WRAP>\\
+<WRAP center round info 75%>
+バージョン NG 754 およびそれ以降{{:wiki:icono-modulo-enterprise.png?23x23|Enterprise 版}}
+</WRAP>\\
+{{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}To configure a historical database, it is necessary to have a new server where to host it (**different from the one of the main database**). Once you have that server where MySQL is installed, follow these steps:
+{{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}ヒストリデータベースを設定するには、それをホストする新しいサーバが必要です(**メインデータベースのサーバとは異なります**)。MySQL がインストールされているサーバを用意したら、次の手順に従います。
+In Pandora FMS console, go to ►**Setup** → **Setup** → **Historical database** to access [[:en:documentation:04_using:12_console_setup#the_history_database|connection configuration]] (**Configure connection target**).
+Pandora FMS コンソールで、**セットアップ(Setup)** → **セットアップ(Setup)** → **ヒストリデータベース(Historical database)** へ行き、[[:ja:documentation:04_using:12_console_setup#ヒストリデータベース|接続設定]] (**接続先設定(Configure connection target)**) にアクセスします。
+{{  :wiki:pandora_console_06.png  }}
+Fill in the following fields:
+次のフィールドを入力します。
+  * **Host**: Host name (web link or IP address) of the history database.
+  * **Port**: Connection port of the history database. Stardard value: ''3306''.
+  * **Database name**: Name of the history database. Default value: ''pandora''.
+  * **Database user**: History database user. Default value: ''pandora''.
+  * **Database password**: Password of the history database. This will allow to cennect to the history database. Next fill in the custom parameters (**Customize settings**):
+  * **ホスト(Host)**: ヒストリデータベースのホスト名(または IP アドレス)
+  * **ポート(Port)**: ヒストリデータベースの接続ポート番号。標準は、''3306'' です。
+  * **データベース名(Database name)**: ヒストリデータベースの名前。デフォルトは ''pandora'' です。
+  * **データベースユーザ(Database user)**: ヒストリデータベースユーザ。デフォルトは ''pandora'' です。
+  * **データベースパスワード(Dabase password)**: ヒストリデータベースのパスワード。これにより、ヒストリデータベースに接続できるようになります。 次に、カスタムパラメータを入力します(**設定のカスタマイズ**):
+{{  :wiki:pandora_console_06-1.png  }}
+The last fields of this form **Data days old to keep in active database, Transference block size (Step)**  and **Delay betewwn transferences (seconds)**  will define the way in which the data will be sent to the historical database, that is, the oldest data those with more than n //days (Data days)//  will be moved to the history database in blocks of made of n rows (//Step//) waiting n seconds (//Delay//) between one block and the next to avoid overloads.
+このフォームの最後のフィールド**アクティブなデータベースに保持するデータ日数、転送ブロックサイズ(ステップ)** および **転送の遅延(秒)** は、データがヒストリデータベースへ送信される方法を定義します。つまり、オーバーロードを避けるために、n //日(データ日)//以上前の古いデータが、n 行(//ステップ//)単位で、それぞれの送信単位の間に n 秒(//遅延//)待機しながらヒストリデータベースに移動されます。
+In the same screen, it is also possible to decide whether to send the events with more than n days to the history database (**Events days old to keep in active database**), although it must be taken into account that including the events will considerably increase the growth rate of the historical database, and that these will only be consulted when generating reports, not in the event view.
+同じ画面で、n 日を超えるイベントをヒストリデータベースに送信するかどうかを決定することもできます(**アクティブなデータベースにイベントを保持する日数**)。ただし、 イベントはヒストリデータベースを大幅に増大させることと、レポートを生成するときにのみ参照されイベント表示では参照されない点を考慮する必要があります。
+<WRAP center round tip 75%>
+{{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}The historical database is a feature of the Enterprise version that uses the ''/usr/bin/pandora_db''  binary to transfer data. In addition, you must configure the settings [[:en:documentation:04_using:12_console_setup#history_database_maintenance_options|for the maintenance of the history database]].
+</WRAP>
+<WRAP center round tip 75%>
+{{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}ヒストリデータベースは、''/usr/bin/pandora_db'' バイナリを使用してデータを転送する Enterprise 版の機能です。加えて、[[:ja:documentation:04_using:12_console_setup#ヒストリデータベースメンテナンスオプション|ヒストリデータベースのメンテナンス]]設定を行う必要があります。
+</WRAP>
+=== NG 753 およびそれ以前のバージョンにおけるヒストリデータベース ===
+<WRAP center round info 75%>
+These steps are only for version 753 and previous versions. From version 754 the only thing necessary is to configure the connection values explained in the previous section and Pandora FMS will take care of the whole installation process and the [[:en:documentation:04_using:12_console_setup#history_database_maintenance_options|maintenance of the historical database]].
+</WRAP>
+<WRAP center round info 75%>
+こちらの手順は、バージョン 753 およびそれ以前のバージョンのみを対象としています。バージョン 754 以降、必要なのは前の章で説明した接続値を設定することだけです。Pandora FMS は、インストールプロセス全体と [[:ja:documentation:04_using:12_console_setup#ヒストリデータベースメンテナンスオプション|ヒストリデータベースのメンテナンス]]を処理します。
+</WRAP>
+{{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise version}}To configure a historical database, it is necessary to have a new server where to host it (**different from the one of the main database**). Once you have that server where MySQL is installed, follow these steps:
 {{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}ヒストリデータベースを設定するには、それを格納する(メインのデータベースとは異なる)新たなサーバが必要です。MySQL をインストールしたサーバを準備したら、以下の手順を実行します。
-  * 新たなヒストリデータベースを作成します。
+   * Create the new historical database:
+   * 新たなヒストリデータベースを作成します。
 <code>
@@ 行 548: / 行 620: @@
   * Pandora FMS データベーススキーマを作成します。Pandora FMS コンソールと共に提供されている ''/var/www/html/pandora_console/pandoradb.sql'' が利用できます。それをヒストリデータベースサーバへコピーします。
-  cat pandoradb.sql | mysql -u user -p -D history_db
+<code bash>
+cat pandoradb.sql | mysql -u root -p -D pandora_history
+</code>
   * Grant permissions to a user (''user''  and ''password)''  which will be used from the Pandora FMS server and console to send and check historical data:
@@ 行 554: / 行 630: @@
   * ヒストリデータベースにアクセスできるように Pandora FMS サーバとコンソールで利用するユーザのパーミッション(''user'' と ''password'')を設定します。
-  GRANT ALL PRIVILEGES ON pandora_history.* TO 'user'@'%' IDENTIFIED BY 'password';
+**For MySQL 5.7**
-=== ヒストリデータベースの設定 ===
-{{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}In Pandora FMS console, go to **Setup> Setup> Enterprise** to access [[:en:documentation:04_using:12_console_setup#historical_database|connection configuration]] (**Configure connection target**).
+**MySQL 5.7 向け:**
-{{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}Pandora FMS コンソールにて、[[:ja:documentation:04_using:12_console_setup#ヒストリデータベース|接続設定]] へアクセスするために、**セットアップ(setup) > Enterprise** へ行きます。
+<code bash>
+GRANT ALL PRIVILEGES ON pandora_history.* TO 'user'@'%' IDENTIFIED BY 'password';
-{{  :wiki:pandora_console_06.png  }}
-Fill in the following fields:
+</code>
-次のフィールドに入力します。
+**For MySQL 8:**
-  * **Host**: Host name (web link or IP address) of the history database.
+**MySQL 8 向け:**
-  * **Port**: Connection port of the history database. Stardard value: ''3306''.
-  * **Database name**: Name of the history database. Default value: ''pandora''.
-  * **Database user**: History database user. Default value: ''pandora''.
-  * **Database password**: Password of the history database. This will allow to cennect to the history database. Next fill in the custom parameters (**Customize settings**):
-  * **ホスト(Host)**: ヒストリデータベースのホスト名(Webリンクまたは IP アドレス)。
+  * ''$DBROOTPASS'': MySQL 8 **root**  user password.
-  * **ポート(Port)**: ヒストリデータベースの接続ポート。標準は ''3306'' です。
+  * ''$DBUSER'': MySQL 8 user name.
-  * **データベース名(Database name)**: ヒストリデータベースの名前。デフォルトは ''pandora'' です。
+  * ''$DBPASS'': MySQL 8 user password.
-  * **データベースユーザ(Database user)**: ヒストリデータベースユーザ。デフォルトは ''pandora'' です。
+  * ''$DBPORT'': Connection port for MySQL 8.
-  * **データベースパスワード(Database password)**: ヒストリデータベースのパスワード。これにより、ヒストリデータベースへ接続することができます。次に、カスタムパラメータを入力します(**設定のカスタマイズ**):
+  * ''$DBHOST'': IP address or FQDN of the MySQL server 8.
+  * ''$DBNAME'': Name of the database.
-{{  :wiki:pandora_console_06-1.png  }}
+  * ''$DBROOTPASS'': MySQL 8 **root** ユーザパスワード。
+  * ''$DBUSER'': MySQL 8 ユーザ名。
+  * ''$DBPASS'': MySQL 8 ユーザパスワード。
+  * ''$DBPORT'': MySQL 8 用接続ポート。
+  * ''$DBHOST'': MySQL 8 サーバの IP アドレスまたは FQDN。
+  * ''$DBNAME'': データベース名。
-The last fields of this form **Data days old to keep in active database, Transference block size (Step)**  and **Delay betewwn transferences (seconds)**  will define the way in which the data will be sent to the historical database, that is, the oldest data those with more than n //days (Data days)// will be moved to the history database in blocks of made of n rows (//Step//) waiting n seconds (//Delay//) between one block and the next to avoid overloads.
+To use these environment variables just define them before running //grants// in the terminal, enter the following:
-このフォームの最後のフィールド **アクティブなデータベースに保持するデータ日数、転送ブロックサイズ(ステップ)** および **転送の遅延(秒)** は、データをヒストリデータベースに送信される方法を定義します。つまり、n //日(Data days)// を超える最も古いデータは、n 行(//Step//)ごとに、オーバーロードを回避するために 1つのブロックと次のブロックの間を n 秒(//Delay//)待機し、ヒストリデータベースに移動されます。
+これらの環境変数を使用するには、//GRANT// を実行する前に次のようにターミナルで設定するだけです。
-In the same screen, it is also possible to decide whether to send the events with more than n days to the history database (**Events days old to keep in active database**), although it must be taken into account that including the events will considerably increase the growth rate of the historical database, and that these will only be consulted when generating reports, not in the event view.
+<code bash>
+env TZ='Europe/Madrid' \
+ DBHOST='127.0.0.1' \
+ DBNAME='pandora' \
+ DBUSER='pandora' \
+ DBPASS='pandora' \
+ DBPORT='3306' \
+ DBROOTPASS='pandora'
-同じ画面で、n日を超えるイベントをヒストリデータベースに送信するかどうかを決定することもできます（**アクティブなデータベースに保持する古いイベント(Events days old to keep in active database)**）。ただし、イベントはヒストリデータベースの増大率を大幅に増加させます。また、これらはイベント表示ではなく、レポートを生成するときにのみ参照されます。
+</code>
-<WRAP center round tip 75%> {{:wiki:icono-modulo-enterprise.png?23x23  |Versión Enterprise}}The historical database is a feature of the Enterprise version that uses the ''/usr/bin/pandora_db''  binary to transfer data. </WRAP>
+Enter in the terminal:
-<WRAP center round tip 75%> {{:wiki:icono-modulo-enterprise.png?23x23  |Enterprise 版}}
+ターミナルで以下を実行します:
-ヒストリデータベースの機能は Enterprise 版の機能で、データを転送するのに ''/usr/bin/pandora_db'' バイナリを用います。
-</WRAP>
-=== ヒストリデータベースの削除と圧縮設定 ===
+<code bash>
+systemctl restart mysql
-History database is supposed to contain all history data, but if you want to delete old data, or compact them, you will need to use some specific data in database that take into account the script **pandora_db** when executed from the node.
+</code>
-ヒストリデータベースは、"過去の全データ" を保存することを想定しています。しかし、古いデータを削除したり圧縮したい場合は、**pandora_db** スクリプトを通常の DB に対する動作に見せかけて実行する必要があります。そのためには、ヒストリデータベースに何らかのデータが入っている必要があります。
+Enter in the terminal:
-First, enter some data from the history database in //tconfig// table. Use this SQL queries to create a minimal configuration and configure the performance od **pandora_db** when executed against the history databas. First you need to connect to your database using the command line (CLI) of MySQL.
+ターミナルで以下を実行します:
-最初に、pandora_db ツールによって利用できるように、//tconfig// テーブルを適切な値を入れた状態で用意する必要があります。**pandora_db** の実行に必要な最小限の設定を行うために、ヒストリデータベースに対して以下の SQL を実行します。まずは、mysql の CLI を利用して、データベースに接続する必要があります。
+<code bash>
-This is an example, replace values according to your criteria (but leave ''history_db_enabled'' at zero):
+export MYSQL_PWD=$DBROOTPASS
+echo "CREATE USER  \"$DBUSER\"@'%' IDENTIFIED BY \"$DBPASS\";" | mysql -uroot -P$DBPORT -h$DBHOST
+echo "ALTER USER \"$DBUSER\"@'%' IDENTIFIED WITH mysql_native_password BY \"$DBPASS\"" | mysql -uroot -P$DBPORT -h$DBHOST
+echo "GRANT ALL PRIVILEGES ON $DBNAME.* TO \"$DBUSER\"@'%'" | mysql -uroot -P$DBPORT -h$DBHOST
-以下が例です。値は必要に応じて書き換えてください。(ただし、history_db_enabled は 0 にしてください)
+export MYSQL_PWD=$DBPASS
+</code>
+The history database (DB) can contain //all the system data//  (without limit), but if you want to delete data or compact them from the history database, you will need to use specific data in the database that the **pandora_db**  script takes into account when executing from the node.
+ヒストリデータベース(DB)には//すべてのシステムデータ//(無制限)を含めることができますが、ヒストリデータベースからデータを削除または圧縮する場合は、**pandora_db** スクリプトがノードから実行される際の設定を示すデータベース内の特定のデータを使用する必要があります。
+<WRAP center round info 60%>
+Remember that all these steps are only for version 753 and earlier versions.
+</WRAP>
+<WRAP center round info 60%>
+これらの手順はすべて、バージョン 753 以前のバージョンのみを対象としていることに注意してください。
+</WRAP>
+First, enter some data from the history database in //tconfig//  table. Use this SQL queries to create a minimal configuration and configure the performance od **pandora_db**  when executed against the history database. First you need to connect to your database using the command line (CLI) of MySQL.
+まず、ヒストリデータベースのデータを //tconfig// テーブルに入力します。 この SQL クエリを使用して最小限の設定を作成し、**pandora_db** がヒストリデータベースに対して実行される際の設定をします。 まず、MySQL のコマンドライン(CLI)を使用してデータベースに接続する必要があります。
+This is an example, replace values according to your criteria (but leave ''history_db_enabled''  at zero):
+これは例です。値は好みに応じて置き換えます(ただし、''history_db_enabled'' はゼロのままにします)。
 <code>
- INSERT INTO `tconfig` VALUES (1,'days_purge','180');
- INSERT INTO `tconfig` VALUES (2,'history_db_enabled','0');
+INSERT INTO `tconfig` VALUES (1,'days_purge','180');
- INSERT INTO `tconfig` VALUES (3,'days_compact','120');
+INSERT INTO `tconfig` VALUES (2,'history_db_enabled','0');
- INSERT INTO `tconfig` VALUES (4,'step_compact','1');
+INSERT INTO `tconfig` VALUES (3,'days_compact','120');
- INSERT INTO `tconfig` VALUES (5,'event_purge','180');
+INSERT INTO `tconfig` VALUES (4,'step_compact','1');
- INSERT INTO `tconfig` VALUES (6,'string_purge','180');
+INSERT INTO `tconfig` VALUES (5,'event_purge','180');
- INSERT INTO `tconfig` VALUES (7,'MR','0');
+INSERT INTO `tconfig` VALUES (6,'string_purge','180');
+INSERT INTO `tconfig` VALUES (7,'MR','<actual MR value>');
 </code>
-  * This example is for the history database ito store for 6 months (180 days) from the execution date.
+  * Take special care to replace ''< actual MR value >''  with the current MR value that you currently have in the main Pandora FMS server.
-  * Compact data more than 4 months old (120 days).
+  * This example is for the history database ito store for 6 months (180 days) from the execution date (''days_purge'').
-  * If you have 1 month worth of data in your main database, you will have a total of 6 months of data, because the last month has no data in the history database, but it has them in the main database.
+  * Compact data more than 120 days old (''days_compact'').
-  * You may type in any value here, there is no limit of data storage in history database aprt from the machine's free space. Just remember that the history database must be in a physical server separated from the main DB and Pandora FMS.
+  * If you have 1 month worth of data in your main database, you will have a total of 6 months of data, because the last month has no data in the history database, but it has them in the main database (''event_purge''  y ''string_purge'').
+  * //Use the values that you think convenient//  (except for ''MR''  and ''history_db_enabled''). The limit in the storage of the history database only depends on the free space of the machine. **Just remember that the history database must be in a physical server independent**  from the main database and Pandora FMS.
-  * この例は、ヒストリデータベースに(現在からさかのぼること) 6ヶ月間データを保存します。
+  * ''< actual MR value >'' を、メインの Pandora FMS サーバの現在の MR 値に置き換える場合は特に注意してください。
-  * 4ヶ月(120日)前のデータを圧縮することを意味します。
+  * この例は、ヒストリデータベースに過去 6ヵ月間(180日)のデータを保存します。(''days_purge'')
-  * メインのデータベースに 1ヶ月間のデータがあるとしても、トータルで 6ヶ月間のデータとなります。なぜなら、直近 1ヶ月のデータはメインデータベースから読まれ、それ以外はヒストリデータベースから読まれるためです。
+  * 120日より古いデータを圧縮します。(''days_compact'')
-  * これらには任意の値を設定できます。ヒストリデータベースにはデータ量の上限はありません。ただし、ヒストリデータベースは、メインデータベースおよび Pandora FMS サーバやコンソールが動作しているマシンとは物理的に異なるマシンに配置しなければいけないことを理解してください。
+  * メインデータベースに最低 1ヵ月分のデータがある場合、前月分がヒストリデータベースになくてもメインデータベースにはデータがあるため、合計 6か月のデータを参照できます。(''event_purge'' および ''string_purge'')
+  * //各値は任意に変更してください//(''MR'' および ''history_db_enables'' は除く)。ヒストリデータベースのストレージの上限は、マシンの空き容量にのみ依存します。 **ヒストリデータベースは、メインデータベースおよび Pandora FMS から独立した物理サーバ** にある必要があることに注意してください。
-<WRAP center round tip 75%> In versions prior to Pandora FMS 753 you must execute the script **pandora_db**  in the history server itself using the data specified previously in the database and additionnally create the configuration file as explained below, in order to use the maintenance script as if we were using a normal database. </WRAP>
+<WRAP center round tip 75%>
-<WRAP center round tip 75%> Pandora FMS 753 より前のバージョンでは、通常のデータベースと同じように、前述のデータベースと以降で説明する追加の設定ファイルを用いてヒストリサーバでメンテナンスのために **pandora_db** スクリプトを実行する必要があります。</WRAP>
+In versions prior to Pandora FMS 753 you must execute the script **pandora_db**  in the history server itself using the data specified previously in the database and additionnally create the configuration file as explained below, in order to use the maintenance script as if we were using a normal database.
+</WRAP>
+<WRAP center round tip 75%>
+Pandora FMS 753 以前のバージョンでは、通常のデータベースのように、データベースであらかじめ設定したデータを使用してヒストリデータベースサーバ自体でメンテナンススクリプト **pandora_db** を実行し、さらに以下で説明するように設定ファイルを作成する必要があります。
+</WRAP>
 In versions prior to Pandora FMS 753, create an additional ''pandora_server.conf''  file. Use this small version to create your own and name it ''/etc/pandora/pandora_server_history_db.conf''  :
-Pandora FMS 753 までのバージョンでは、追加の ''pandora_server.conf'' ファイルを作成する必要があります。次のような内容で、''/etc/pandora/pandora_server_history_db.conf'' として作成します。
+Pandora FMS 753 以前のバージョンでは、追加の ''pandora_server.conf'' ファイルを作成します。独自の設定ファイルとして ''/etc/pandora/pandora_server_history_db.conf'' という名前を付けます。
 <code>
 dbengine mysql
-dbname pandora4_history
+dbname pandora_history
-dbuser pandora4_history
+dbuser user
-dbpass 1234
+dbpass password
-dbhost 192.168.50.23
+dbhost 192.168.70.140
 log_file /var/log/pandora/pandora_db_history.log
 </code>
+<WRAP center round info 60%>
+Remember that all these steps are only for version 753 and earlier versions.
+</WRAP>
+<WRAP center round info 60%>
+これらの手順はすべて、バージョン 753 以前のバージョンのみを対象としていることに注意してください。
+</WRAP>
 Now you can execute **pandora_db**  tool against the history database configuration and program it for its periodical execution:
-これで、ヒストリデータベースに対して **pandora_db** ツールの定期実行をプログラムできます。
+これで、ヒストリデータベースに対して **pandora_db** ツールを実行できるようになり、定期的に実行するように設定できます。
 <code>
@@ 行 657: / 行 787: @@
 </code>
-また、設定値は[[:ja:documentation:04_using:12_console_setup#ヒストリデータベースメンテナンスオプション|こちら]]に説明しているようにコンソールからも入力できます。
+<WRAP center round tip 60%> This process SHOULD NOT affect your main operation because it is running against a different database in a different server. </WRAP>
+<WRAP center round tip 60%>この処理は、別のサーバの別のデータベースに対して実行されるため、メインのデータベースには影響を与えません。</WRAP>
-<WRAP center round tip 60%>
-この処理は、メインのデータベースには影響しません。なぜなら、異なるサーバの異なるデータベースに対して行っているためです。
-</WRAP>
 [[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]