ja:documentation:pandorafms:management_and_operation:dynamic_reports

差分

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

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
ja:documentation:pandorafms:management_and_operation:dynamic_reports [2026/07/04 22:36] – [Design Builder] junichija:documentation:pandorafms:management_and_operation:dynamic_reports [2026/07/04 22:58] (現在) – [Report ACLs] junichi
行 161: 行 161:
 <wrap #ks2_2_1 /> <wrap #ks2_2_1 />
  
-=== Widgets ===+=== ウィジェット ===
  
 Widgets are the elements that can be added in the Designs to display report data. Each Widget, according to its operation, has its own configuration. Widgets are the elements that can be added in the Designs to display report data. Each Widget, according to its operation, has its own configuration.
 +
 +ウィジェットは、レポートデータを表示するためにデザインに追加できる要素です。各ウィジェットには、その動作に応じた独自の設定があります。
  
 Widgets can be placed in any position within a page. They can also be resized, but depending on the Widget they have minimum and maximum dimensions to be displayed correctly. Widgets can be placed in any position within a page. They can also be resized, but depending on the Widget they have minimum and maximum dimensions to be displayed correctly.
 +
 +ウィジェットはページ内の任意の場所に配置できます。サイズ変更も可能ですが、ウィジェットによっては、正しく表示するために最小および最大のサイズが定められています。
  
 When a Widget is added to a page it must be configured, which can be done from the drop-down menu in its upper right corner or by double-clicking on it. When a Widget is added to a page it must be configured, which can be done from the drop-down menu in its upper right corner or by double-clicking on it.
 +
 +ウィジェットをページに追加した際は設定を行う必要があり、その設定はウィジェットの右上にあるドロップダウンメニューから、またはウィジェットをダブルクリックすることで行えます。
  
 Some Widgets, such as module graphs, can be configured in two different ways: Some Widgets, such as module graphs, can be configured in two different ways:
 +
 +モジュールグラフなどの一部のウィジェットは、2通りの方法で設定できます。
  
   * **Static configuration**: The Widget configuration uses specific elements as a Data source.   * **Static configuration**: The Widget configuration uses specific elements as a Data source.
 +
 +  * **静的設定(Static configuration)**: ウィジェットの設定において、特定の要素をデータソースとして使用します。
  
 For example, in a module graph, it is a specific module of an agent. For example, in a module graph, it is a specific module of an agent.
 +
 +例えば、モジュールグラフにおいては、それはエージェントの特定のモジュールです。
  
   * **Dynamic configuration**: The Widget configuration uses a Data source external to the Design. The configuration is generally done with regular expressions, generating an element in the report for each match it has in the Data source.   * **Dynamic configuration**: The Widget configuration uses a Data source external to the Design. The configuration is generally done with regular expressions, generating an element in the report for each match it has in the Data source.
 +
 +  * **動的設定(Dynamic configuration)**: ウィジェットの設定には、デザインの外部にあるデータソースが使用されます。設定は一般的に正規表現を用いて行われ、データソース内で一致する項目が見つかるたびに、レポート内に要素が生成されます。
  
 For example, for module graphs, the Widget could be configured so that a graph is generated in the report for all agents (''.*'') with modules that include "CPU" in their name (''.*CPU.*''). For example, for module graphs, the Widget could be configured so that a graph is generated in the report for all agents (''.*'') with modules that include "CPU" in their name (''.*CPU.*'').
 +
 +例えばモジュールグラフの場合、名前に「CPU」を含むモジュール(''.*CPU.*'')を持つすべてのエージェント(''.*'')について、レポート内にグラフが生成されるようにウィジェットを設定できます。
  
 {{  :wiki:REPORTS_02.png  }} {{  :wiki:REPORTS_02.png  }}
  
 Widgets with dynamic configuration can therefore generate as many new elements and pages in the final report as necessary, but they will always occupy at least their assigned space. Widgets with dynamic configuration can therefore generate as many new elements and pages in the final report as necessary, but they will always occupy at least their assigned space.
 +
 +したがって、動的な設定が可能なウィジェットは、最終的なレポートにおいて必要な数だけ新しい要素やページを生成できますが、割り当てられたスペースは常に最低限確保することになります。
  
 Some Widgets, due to their own operation, despite not being dynamic elements depend on Data sources to be able to display information. For example, the <wrap :en>**Top N of agent modules**</wrap> Widget. Some Widgets, due to their own operation, despite not being dynamic elements depend on Data sources to be able to display information. For example, the <wrap :en>**Top N of agent modules**</wrap> Widget.
 +
 +一部のウィジェットは、動的な要素ではないにもかかわらず、その動作の仕組み上、情報を表示するためにデータソースを必要とします。例えば、「**エージェントモジュールのトップ N (Top N of agent modules)**」ウィジェットなどがこれに該当します。
  
 The report generation will try to calculate the best positions for the additional elements it has to add due to dynamic configurations, always respecting the defined Design as much as possible. The report generation will try to calculate the best positions for the additional elements it has to add due to dynamic configurations, always respecting the defined Design as much as possible.
 +
 +レポート生成機能は、動的な構成変更に伴って追加が必要となる要素について、定義されたデザインを可能な限り尊重しつつ、その最適な配置を算出しようと試みます。
  
 In the Design Builder, dynamic elements will be displayed differently, representing that they can expand to the right and/or downwards whenever they can. In the Design Builder, dynamic elements will be displayed differently, representing that they can expand to the right and/or downwards whenever they can.
 +
 +デザインビルダーでは、動的要素は、可能な場合に右方向や下方向へ拡張できることを示すように表示されます。
  
 {{  :wiki:REPORTS_03.png  }} {{  :wiki:REPORTS_03.png  }}
  
 <wrap #ks2_2_2 /> <wrap #ks2_2_2 />
-=== Drafts ===+ 
 +=== 下書き ===
  
 The Builder uses a Draft system for each user in each Design. At the moment a user starts making changes to a Design, those changes are stored in a new Draft. The Builder uses a Draft system for each user in each Design. At the moment a user starts making changes to a Design, those changes are stored in a new Draft.
 +
 +ビルダーは、各デザインにおいてユーザごとに「下書き」システムを使用します。ユーザーがデザインの変更を開始した時点で、その変更内容は新しい下書きに保存されます。
  
 These Drafts allow the user to leave the application and return at any time to resume the editing work. It is not until changes are saved with the ''Save'' button that the changes are effective and usable for new reports that are generated. These Drafts allow the user to leave the application and return at any time to resume the editing work. It is not until changes are saved with the ''Save'' button that the changes are effective and usable for new reports that are generated.
 +
 +この「下書き」機能により、ユーザはアプリケーションを一旦離れても、いつでも作業を再開して編集を続けることができます。「保存(Save)」ボタンで変更内容を保存して初めて、その変更が有効となり、新たに生成されるレポートに反映されるようになります。
  
 In case of concurrency when editing a Design, users will be notified at the moment of entering the Builder. This way, users will have to decide whether to discard their Draft (in case they already have it in progress) or if they save the changes they have. In case of concurrency when editing a Design, users will be notified at the moment of entering the Builder. This way, users will have to decide whether to discard their Draft (in case they already have it in progress) or if they save the changes they have.
 +
 +デザインの編集時に同時編集が発生する場合、ユーザはビルダーに入った時点でその旨の通知を受け取ります。その際、ユーザは(すでに作成中の下書きがある場合は)下書きを破棄するか、それとも現在の変更内容を保存するかを選択する必要があります。
  
 The undo and redo actions will only work with changes made in a Draft. That is, the moment a configuration is saved or discarded, it will not be possible to undo or redo with the action buttons. The undo and redo actions will only work with changes made in a Draft. That is, the moment a configuration is saved or discarded, it will not be possible to undo or redo with the action buttons.
 +
 +「元に戻す」および「やり直し」の操作は、下書き内で行われた変更に対してのみ有効です。つまり、設定が保存または破棄された時点で、これらの操作ボタンを使用して変更を取り消したり、やり直したりすることはできなくなります。
  
 <wrap #ks3 /> <wrap #ks3 />
-===== Data sources =====+ 
 +===== データソース =====
  
 Data sources allow defining sets of agents and agent groups that will be used in report generation for dynamically configured elements. Data sources allow defining sets of agents and agent groups that will be used in report generation for dynamically configured elements.
 +
 +データソースを使用すると、動的に構成される要素のレポート生成に使用するエージェントやエージェントグループのセットを定義できます。
  
 This section is accessible from the side menu in ''Operation > Reporting > Dynamic reports > Data sources'' This section is accessible from the side menu in ''Operation > Reporting > Dynamic reports > Data sources''
 +
 +このセクションには、サイドメニューの「操作(Operation) > レポート(Reporting) > 動的レポート(Dynamic reports) > データソース(Data sources)」からアクセスできます。
  
 When creating a Data source, it is first necessary to indicate at least: When creating a Data source, it is first necessary to indicate at least:
 +
 +データソースを作成する際は、まず少なくとも以下を指定する必要があります。
  
   * Name.   * Name.
   * Group.   * Group.
   * Description (Optional).   * Description (Optional).
 +
 +  * 名前 
 +  * グループ 
 +  * 説明(任意)
  
 The group is very important to limit other users' access to said Data source: The group is very important to limit other users' access to said Data source:
 +
 +当該データソースへの他のユーザのアクセスを制限する上で、そのグループは非常に重要です。
  
   * If the Data source belongs to the "All" group:   * If the Data source belongs to the "All" group:
行 223: 行 269:
     * It can be used by users with ''RR'', ''RW'' or ''RM'' permission on said group.     * It can be used by users with ''RR'', ''RW'' or ''RM'' permission on said group.
     * It can only be edited, duplicated or deleted by administrator users or with ''RW'' permission on said group.     * It can only be edited, duplicated or deleted by administrator users or with ''RW'' permission on said group.
 +
 +  * データソースが「すべて」グループに属している場合:
 +    * いずれかのグループに対して ''RR''、''RW''、または ''RM'' の権限を持つすべての環境ユーザが、そのデータソースを使用できます。 
 +    * 管理者ユーザー、または「すべて」グループに対する明示的な ''RW'' 権限を持つユーザのみが、そのデータソースの編集、複製、または削除を行えます。
 +  * データソースが別のグループに属している場合:
 +    * そのグループに対して ''RR''、''RW''、または ''RM'' の権限を持つユーザーが、そのデータソースを使用できます。 
 +    * 管理者ユーザ、またはそのグループに対する ''RW'' 権限を持つユーザーのみが、そのデータソースの編集、複製、または削除を行えます。
  
 Besides that basic information, the elements that are part of the Data source must be indicated: Besides that basic information, the elements that are part of the Data source must be indicated:
 +
 +その基本情報に加え、データソースを構成する要素を示す必要があります。
  
   * Agents.   * Agents.
行 230: 行 285:
   * Agent Wildcards: They are regular expressions that are evaluated for agents at the time of generating a report based on the permissions of the user generating the report.   * Agent Wildcards: They are regular expressions that are evaluated for agents at the time of generating a report based on the permissions of the user generating the report.
   * Group Wildcards: They are regular expressions that are evaluated for groups at the time of generating a report based on the permissions of the user generating the report.   * Group Wildcards: They are regular expressions that are evaluated for groups at the time of generating a report based on the permissions of the user generating the report.
 +
 +  * エージェント。
 +  * グループ。
 +  * エージェントワイルドカード:レポートを生成するユーザの権限に基づき、レポート生成時にエージェントに対して評価される正規表現です。
 +  * グループワイルドカード:レポートを生成するユーザの権限に基づき、レポート生成時にグループに対して評価される正規表現です。
  
 Data sources are optional for report generation, since a Design could exclusively have statically configured [[#ks2_2_1|Widgets]]. Data sources are optional for report generation, since a Design could exclusively have statically configured [[#ks2_2_1|Widgets]].
 +
 +デザインが静的に構成されたウィジェットのみで構成される場合もあるため、レポート生成においてデータソースは必須ではありません。
  
 <wrap #ks4 /> <wrap #ks4 />
-===== Definitions =====+ 
 +===== 定義 =====
  
 Report's Definitions are reusable and programmable configurations for effective report generation. Report's Definitions are reusable and programmable configurations for effective report generation.
 +
 +レポート定義は、効果的なレポート生成を行うための、再利用可能かつプログラム可能な設定です。
  
 This section is accessible from the side menu in ''Operation > Reporting > Dynamic reports > Definitions''. This section is accessible from the side menu in ''Operation > Reporting > Dynamic reports > Definitions''.
 +
 +このセクションには、サイドメニューの「操作(Operation) > レポート作成(Reporting) > 動的レポート(Dynamic reports) > 定義(Definitions)」からアクセスできます。
  
 When creating a Definition, it is first necessary to indicate at least: When creating a Definition, it is first necessary to indicate at least:
 +
 +定義を作成する際は、まず少なくとも以下を示す必要があります。
  
   * Name.   * Name.
行 249: 行 318:
   * Use custom time period: In case it is enabled, a specific time period different from the one configured in each [[#ks2_2_1|Widgets]] of the design can be used to use it in all Widgets when generating the report.   * Use custom time period: In case it is enabled, a specific time period different from the one configured in each [[#ks2_2_1|Widgets]] of the design can be used to use it in all Widgets when generating the report.
   * Notify: If enabled, the user will receive a notification in the console when the report has finished generating.   * Notify: If enabled, the user will receive a notification in the console when the report has finished generating.
 +
 +  * 名前(Name)
 +  * 説明(Description)(任意)
 +  * グループ(Group)
 +  * デザイン(Design)
 +  * データソース(Data source)(任意)
 +  * カスタム期間を使用(Use custom time period):これを有効にすると、レポート生成時に、デザイン内の各[[#ks2_2_1|ウィジェット]]で設定された期間とは異なる特定の期間を、すべてのウィジェットに対して適用できます。
 +  * 通知(Notify):これを有効にすると、レポートの生成完了時にコンソールで通知を受け取ります。
  
 The group is very important to limit other users' access to said Definition: The group is very important to limit other users' access to said Definition:
 +
 +そのグループは、当該定義への他のユーザのアクセスを制限する上で非常に重要です。
  
   * If the Definition belongs to the "All" group:   * If the Definition belongs to the "All" group:
行 258: 行 337:
     * It can be used by users with ''RR'', ''RW'' or ''RM'' permission on said group.     * It can be used by users with ''RR'', ''RW'' or ''RM'' permission on said group.
     * It can only be edited, duplicated or deleted by administrator users or with ''RW'' or ''RM'' permission on said group, and the Definition owner.     * It can only be edited, duplicated or deleted by administrator users or with ''RW'' or ''RM'' permission on said group, and the Definition owner.
 +
 +  * 定義が「すべて」グループに属している場合:
 +    * 任意のグループに対して ''RR''、''RW''、または ''RM'' の権限を持つすべての環境ユーザが、その定義を使用できます。 
 +    * 管理者ユーザ、または「すべて」グループに対する明示的な ''RW'' もしくは ''RM'' 権限を持つユーザー、および定義の所有者のみが、その定義の編集、複製、または削除を行えます。
 +  * 定義が別のグループに属している場合:
 +    * そのグループに対して ''RR''、''RW''、または ''RM'' の権限を持つユーザが、その定義を使用できます。 
 +    * 管理者ユーザ、またはそのグループに対する ''RW'' もしくは ''RM'' 権限を持つユーザ、および定義の所有者のみが、その定義の編集、複製、または削除を行えます。
  
 A Definition can also be scheduled to generate a report periodically. A Definition can also be scheduled to generate a report periodically.
 +
 +定義を設定して、定期的にレポートを生成するようにすることも可能です。
  
 It can also be configured to send the reports it generates by mail (besides being accessible from the console itself). It can also be configured to send the reports it generates by mail (besides being accessible from the console itself).
 +
 +生成されたレポートは、コンソールから直接アクセスできるだけでなく、メールで送信するように設定することも可能です。
  
 <wrap #ks5 /> <wrap #ks5 />
-===== Generated reports =====+ 
 +===== 生成済レポート =====
  
 Generated reports are files stored in the Pandora FMS console that display environment information with a predefined Design and specific Data sources. Generated reports are files stored in the Pandora FMS console that display environment information with a predefined Design and specific Data sources.
 +
 +生成済レポートは、あらかじめ定義されたデザインと特定のデータソースを用いて環境情報を表示する、Pandora FMS コンソールに保存されたファイルです。
  
 [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_8_4|These files are generated in the background]], because they may require a lot of time to complete depending on the amount of data to show. [[:en:documentation:pandorafms:management_and_operation:12_console_setup#ks1_8_4|These files are generated in the background]], because they may require a lot of time to complete depending on the amount of data to show.
 +
 +[[:ja:documentation:pandorafms:management_and_operation:12_console_setup#ks1_8_4|これらのファイルはバックグラウンドで生成されます]]。これは、表示するデータの量によっては生成に長い時間がかかる場合があるためです。
  
 This section is accessible from the side menu in <wrap :en>**Operation → Reporting → Dynamic reports → Generated reports**</wrap>. This section is accessible from the side menu in <wrap :en>**Operation → Reporting → Dynamic reports → Generated reports**</wrap>.
 +
 +このセクションには、サイドメニューの <wrap :ja>**操作(Operation) → レポート(Reporting) → 動的レポート(Dynamic reports) → 生成済レポート(Generated reports)**</wrap> からアクセスできます。
  
 When creating a report, it is first necessary to indicate at least: When creating a report, it is first necessary to indicate at least:
 +
 +レポートを作成する際は、まず少なくとも以下のことを明記する必要があります。
  
   * Name.   * Name.
行 286: 行 385:
   * Use custom time period: In case it is enabled, a specific time period different from the one configured in each [[#ks2_2_1|Widget]] of the design can be used to use it in all Widgets when generating the report.   * Use custom time period: In case it is enabled, a specific time period different from the one configured in each [[#ks2_2_1|Widget]] of the design can be used to use it in all Widgets when generating the report.
   * Notify: If enabled, the user will receive a notification in the console when the report has finished generating.   * Notify: If enabled, the user will receive a notification in the console when the report has finished generating.
 +
 +  * 名前(Name)
 +  * 説明(Description)(任意)
 +  * グループ(Group)
 +  * デザイン(Design)
 +  * レポートタイプ(Report type):以下の4つのタイプがあります。
 +    * HTML:Pandora FMS コンソール上でのみ閲覧可能で、レポート要素を操作できます。 
 +    * PDF:コンソールから閲覧またはダウンロード可能な単一のファイルを生成します。 
 +    * CSV:複数のCSVファイル(各レポート要素につき1つ)をまとめた「.zip」ファイルを生成します。ダウンロードのみ可能で、コンソール上での閲覧はできません。 
 +    * JSON:コンソールから閲覧またはダウンロード可能な単一のファイルを生成します。
 +  * データソース(Data source)(任意)
 +  * カスタム期間の使用(Use custom time period):これを有効にすると、レポート生成時にすべてのウィジェットに対して、各[[#ks2_2_1|ウィジェット]]の設定とは異なる特定の期間を適用できます。
 +  * 通知(Notify):有効にすると、レポートの生成完了時にコンソール上で通知を受け取ります。
  
 The group is very important to limit other users' access to said Definition: The group is very important to limit other users' access to said Definition:
行 294: 行 406:
     * It can be viewed and downloaded by users with ''RR'', ''RW'' or ''RM'' permission on said group.     * It can be viewed and downloaded by users with ''RR'', ''RW'' or ''RM'' permission on said group.
     * It can only be regenerated or deleted by administrator users or with ''RW'' or ''RM'' permission on said group, and the report owner.     * It can only be regenerated or deleted by administrator users or with ''RW'' or ''RM'' permission on said group, and the report owner.
 +
 +当該定義への他のユーザのアクセスを制限する上で、このグループは非常に重要です。
 +  * レポートが「すべて」グループに属している場合:
 +    * いずれかのグループに対して ''RR''、''RW''、または ''RM'' の権限を持つすべての環境ユーザが、そのレポートを閲覧およびダウンロードできます。 
 +    * 管理者ユーザ、または「すべて」グループに対して明示的な ''RW'' もしくは ''RM'' 権限を持つユーザ、およびレポートの所有者のみが、そのレポートを再生成または削除できます。 
 +  * レポートが別のグループに属している場合:
 +    * 当該グループに対して ''RR''、''RW''、または ''RM'' の権限を持つユーザが、そのレポートを閲覧およびダウンロードできます。 
 +    * 管理者ユーザ、または当該グループに対して ''RW'' もしくは ''RM'' の権限を持つユーザ、およびレポートの所有者のみが、そのレポートを再生成または削除できます。
  
 It can also be configured to send the Generated report by mail (besides being accessible from the console itself). It can also be configured to send the Generated report by mail (besides being accessible from the console itself).
 +
 +生成されたレポートは、コンソールから直接アクセスできるだけでなく、メールで送信するように設定することも可能です。
  
 <wrap #ks6 /> <wrap #ks6 />
-===== Report ACLs =====+ 
 +===== レポート ACL =====
  
 In general, report permission bits grant these accesses: In general, report permission bits grant these accesses:
行 334: 行 457:
     * Use Definitions of their group and their own.     * Use Definitions of their group and their own.
     * Edit/Delete Definitions of their group and their own.     * Edit/Delete Definitions of their group and their own.
 +
 +一般的に、レポートの権限ビットは以下のアクセスを許可します。
 +  * **RR**:
 +    * 所属グループおよび自身の生成済みレポートを一覧表示する。 
 +    * 新しいレポートを作成する。 
 +    * 所属グループおよび自身のレポートを閲覧する。 
 +    * 自身のレポートを再生成/削除する。 
 +    * 所属グループおよび自身のレポート定義を一覧表示する。 
 +    * 新しい定義を作成する。 
 +    * 所属グループおよび自身の定義を使用する。 
 +    * 自身の定義を編集/削除する。 
 +  * **RW**:
 +    * 所属グループおよび自身の生成済みレポートを一覧表示する。 
 +    * 新しいレポートを作成する。 
 +    * 所属グループおよび自身のレポートを閲覧する。 
 +    * 所属グループおよび自身のレポートを再生成/削除する。 
 +    * 所属グループおよび自身のレポート定義を一覧表示する。 
 +    * 新しい定義を作成する。 
 +    * 所属グループおよび自身の定義を使用する。 
 +    * 所属グループおよび自身の定義を編集/削除する。 
 +    * 所属グループのデータソースを一覧表示する。 
 +    * データソースを作成する。 
 +    * 所属グループのデータソースを編集/削除する。 
 +    * 所属グループのデザインを一覧表示する。 
 +    * デザインを作成する。 
 +    * 所属グループのデザインを編集/削除する。 
 +  * **RM**:
 +    * 所属グループおよび自身の生成済みレポートを一覧表示する。 
 +    * 新しいレポートを作成する。 
 +    * 所属グループおよび自身のレポートを閲覧する。 
 +    * 所属グループおよび自身のレポートを再生成/削除する。 
 +    * 所属グループおよび自身のレポート定義を一覧表示する。 
 +    * 新しい定義を作成する。 
 +    * 所属グループおよび自身の定義を使用する。 
 +    * 所属グループおよび自身の定義を編集/削除する。
  
 [[:ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]] [[:ja:documentation:pandorafms:start|Pandora FMS ドキュメント一覧に戻る]]
  
  • ja/documentation/pandorafms/management_and_operation/dynamic_reports.1783204575.txt.gz
  • 最終更新: 2026/07/04 22:36
  • by junichi