ArchWiki - 利用者の投稿記録 [ja]

Prometheus

2022-02-12T13:39:37Z

Hirsak13: →エクスポーター: 見出しの階層を訂正

[[Category:ネットワーク監視]]
[[Category:ウェブアプリケーション]]
[[en:Prometheus]]
{{Related articles start}}
{{Related|Zabbix}}
{{Related|Munin}}
{{Related|Grafana}}
{{Related|TICK stack}}
{{Related articles end}}
[https://prometheus.io/ Prometheus] はオープンソースのメトリクス収集・処理ツールです。時系列データベースと保存されているメトリクスにアクセス・処理するクエリ言語から成ります。Prometheus は複数のサービスからメトリクスを収集できます。ミニマルなウェブ UI を備えており、 [[Grafana]] などのサードパーティのツールによるダッシュボードを使うこともできます。

== インストール ==

{{Pkg|prometheus}} パッケージを[[インストール]]してください。その後、{{ic|prometheus}} サービスを[[起動]]・[[有効化]]することで HTTP のポート 9090 からアプリケーションにアクセスできます。

デフォルト設定では自身の {{ic|prometheus}} プロセスを監視します。システムの監視を行うには {{Pkg|prometheus-node-exporter}} をインストールします。ローカルシステムからメトリクスが収集されます。{{ic|prometheus-node-exporter}} サービスを起動・有効化することで使うことができ、デフォルトでポート 9100 が開きます。{{ic|prometheus-node-exporter}} サービスが起動したら、これを定期的にスクレイピングするよう Prometheus の設定をすることにより、実際にデータが収集できるようになります。これは後述の手順 [[#メトリクスの追加|メトリクスの追加]] に従って行います。
{{Warning|デフォルト設定の場合 {{ic|prometheus}} は {{ic|*:9090}} を、 {{ic|prometheus-node-exporter}} は {{ic|*:9100}} を listen します。そのため、忘れずに設定変更、もしくは、対応するファイアウォールのルールを有効にしてください。また、[https://prometheus.io/docs/operating/security/ Prometheus security model] もあわせて確認してください。}}

== 設定 ==

Prometheus の設定は [[Wikipedia:YAML|YAML]] を使用し、メインの設定ファイルは {{ic|/etc/prometheus/prometheus.yml}} です。

=== メトリクスの追加 ===

{{ic|scrape_configs}} 配列にメトリクスの収集先を追加することができます。ソースとしてローカルのノードエクスポータを追加したい場合、設定は以下のようになります:

scrape_configs:
- job_name: 'prometheus'
static_configs:
- targets: ['localhost:9090']
- job_name: 'localhost'
static_configs:
- targets: ['localhost:9100']

== エクスポーター ==
Arch Linuxのリポジトリには [https://prometheus.io/docs/instrumenting/exporters/ 利用可能なエクスポーター] の一部が登録されています:

* {{Pkg|prometheus-node-exporter}} - システムのメトリクス
* {{Pkg|prometheus-blackbox-exporter}} - エンドポイント（HTTP, HTTPS, DNS, TCP, ICMP）に対するブラックボックス探査
* {{Pkg|prometheus-memcached-exporter}} - {{ic|memcached}} のメトリクス
* {{Pkg|prometheus-mysqld-exporter}} - MySQLサーバーのメトリクス

各エクスポーターはサービスの形で実現されています。例えば node exporter を実行する場合は {{ic|prometheus-node-exporter.service}} を [[起動]] ・ [[有効化]] します。

== UI を使う ==

Prometheus には設定を確認したりメトリクスにアクセス・グラフ化するための限定的な UI が付属しています。デフォルトでは http://localhost:9090 から使用できます。Prometheus のクエリ言語について詳しくは [https://prometheus.io/docs/prometheus/latest/querying/basics/ Prometheus のドキュメント] を参照してください。

== アラート ==

{{Pkg|alertmanager}}では、特定の条件を満たした際にカスタマイズしたアラートを送信することができます。
送信する条件は {{ic|/etc/prometheus/alert.rules.yml}} に、送信する内容は {{ic|/etc/alertmanager/alertmanager.yml}} に設定します。アラートマネージャーでは、メールやSlack[https://prometheus.io/docs/alerting/configuration/ など]、さまざまな方法での通知が可能です。メールでのアラートを設定するためには、次の行を追加します:

{{bc|
global:
resolve_timeout: 5m
smtp_smarthost: 'smtp.example.com:25'
smtp_from: 'alertmanager@example.com'
route:
group_by: ['instance', 'severity']
group_wait: 30s
group_interval: 5m
repeat_interval: 3h
receiver: team-1
receivers:
- name: 'team-1'
email_configs:
- to: 'admin@example.com'
}}

Prometheus から AlertManger にアラートを送るためには次の行を {{ic|/etc/prometheus/prometheus.yml}} に追加します:

{{bc|
alerting:
alertmanagers:
- static_configs:
- targets:
- localhost:9093
}}

systemdのユニットが失敗した場合のアラートの設定には {{ic|/etc/prometheus/alert.rules.yml}} に次の行を追加します。このほかの条件については[https://prometheus.io/docs/alerting/configuration/ アラート条件] のドキュメントを参照してください。

{{bc|<nowiki>
- name: systemd_unit
interval: 15s
rules:
- alert: systemd_unit_failed
expr: |
node_systemd_unit_state{state="failed"} > 0
for: 3m
labels:
severity: critical
annotations:
description: 'Instance : Service failed'
summary: 'Systemd unit failed'
</nowiki>}}

== 参照 ==
* [https://prometheus.io/ 公式ホームページ]

Prometheus

2022-02-12T13:36:23Z

Hirsak13: →アラート: 翻訳

[[Category:ネットワーク監視]]
[[Category:ウェブアプリケーション]]
[[en:Prometheus]]
{{Related articles start}}
{{Related|Zabbix}}
{{Related|Munin}}
{{Related|Grafana}}
{{Related|TICK stack}}
{{Related articles end}}
[https://prometheus.io/ Prometheus] はオープンソースのメトリクス収集・処理ツールです。時系列データベースと保存されているメトリクスにアクセス・処理するクエリ言語から成ります。Prometheus は複数のサービスからメトリクスを収集できます。ミニマルなウェブ UI を備えており、 [[Grafana]] などのサードパーティのツールによるダッシュボードを使うこともできます。

== インストール ==

{{Pkg|prometheus}} パッケージを[[インストール]]してください。その後、{{ic|prometheus}} サービスを[[起動]]・[[有効化]]することで HTTP のポート 9090 からアプリケーションにアクセスできます。

デフォルト設定では自身の {{ic|prometheus}} プロセスを監視します。システムの監視を行うには {{Pkg|prometheus-node-exporter}} をインストールします。ローカルシステムからメトリクスが収集されます。{{ic|prometheus-node-exporter}} サービスを起動・有効化することで使うことができ、デフォルトでポート 9100 が開きます。{{ic|prometheus-node-exporter}} サービスが起動したら、これを定期的にスクレイピングするよう Prometheus の設定をすることにより、実際にデータが収集できるようになります。これは後述の手順 [[#メトリクスの追加|メトリクスの追加]] に従って行います。
{{Warning|デフォルト設定の場合 {{ic|prometheus}} は {{ic|*:9090}} を、 {{ic|prometheus-node-exporter}} は {{ic|*:9100}} を listen します。そのため、忘れずに設定変更、もしくは、対応するファイアウォールのルールを有効にしてください。また、[https://prometheus.io/docs/operating/security/ Prometheus security model] もあわせて確認してください。}}

== 設定 ==

Prometheus の設定は [[Wikipedia:YAML|YAML]] を使用し、メインの設定ファイルは {{ic|/etc/prometheus/prometheus.yml}} です。

=== メトリクスの追加 ===

{{ic|scrape_configs}} 配列にメトリクスの収集先を追加することができます。ソースとしてローカルのノードエクスポータを追加したい場合、設定は以下のようになります:

scrape_configs:
- job_name: 'prometheus'
static_configs:
- targets: ['localhost:9090']
- job_name: 'localhost'
static_configs:
- targets: ['localhost:9100']

=== エクスポーター ===
Arch Linuxのリポジトリには [https://prometheus.io/docs/instrumenting/exporters/ 利用可能なエクスポーター] の一部が登録されています:

* {{Pkg|prometheus-node-exporter}} - システムのメトリクス
* {{Pkg|prometheus-blackbox-exporter}} - エンドポイント（HTTP, HTTPS, DNS, TCP, ICMP）に対するブラックボックス探査
* {{Pkg|prometheus-memcached-exporter}} - {{ic|memcached}} のメトリクス
* {{Pkg|prometheus-mysqld-exporter}} - MySQLサーバーのメトリクス

各エクスポーターはサービスの形で実現されています。例えば node exporter を実行する場合は {{ic|prometheus-node-exporter.service}} を [[起動]] ・ [[有効化]] します。

== UI を使う ==

Prometheus には設定を確認したりメトリクスにアクセス・グラフ化するための限定的な UI が付属しています。デフォルトでは http://localhost:9090 から使用できます。Prometheus のクエリ言語について詳しくは [https://prometheus.io/docs/prometheus/latest/querying/basics/ Prometheus のドキュメント] を参照してください。

== アラート ==

{{Pkg|alertmanager}}では、特定の条件を満たした際にカスタマイズしたアラートを送信することができます。
送信する条件は {{ic|/etc/prometheus/alert.rules.yml}} に、送信する内容は {{ic|/etc/alertmanager/alertmanager.yml}} に設定します。アラートマネージャーでは、メールやSlack[https://prometheus.io/docs/alerting/configuration/ など]、さまざまな方法での通知が可能です。メールでのアラートを設定するためには、次の行を追加します:

{{bc|
global:
resolve_timeout: 5m
smtp_smarthost: 'smtp.example.com:25'
smtp_from: 'alertmanager@example.com'
route:
group_by: ['instance', 'severity']
group_wait: 30s
group_interval: 5m
repeat_interval: 3h
receiver: team-1
receivers:
- name: 'team-1'
email_configs:
- to: 'admin@example.com'
}}

Prometheus から AlertManger にアラートを送るためには次の行を {{ic|/etc/prometheus/prometheus.yml}} に追加します:

{{bc|
alerting:
alertmanagers:
- static_configs:
- targets:
- localhost:9093
}}

systemdのユニットが失敗した場合のアラートの設定には {{ic|/etc/prometheus/alert.rules.yml}} に次の行を追加します。このほかの条件については[https://prometheus.io/docs/alerting/configuration/ アラート条件] のドキュメントを参照してください。

{{bc|<nowiki>
- name: systemd_unit
interval: 15s
rules:
- alert: systemd_unit_failed
expr: |
node_systemd_unit_state{state="failed"} > 0
for: 3m
labels:
severity: critical
annotations:
description: 'Instance : Service failed'
summary: 'Systemd unit failed'
</nowiki>}}

== 参照 ==
* [https://prometheus.io/ 公式ホームページ]

Prometheus

2021-10-26T13:33:42Z

Hirsak13: →エクスポーター: 翻訳

[[Category:ネットワーク監視]]
[[Category:ウェブアプリケーション]]
[[en:Prometheus]]
{{Related articles start}}
{{Related|Zabbix}}
{{Related|Munin}}
{{Related|Grafana}}
{{Related|TICK stack}}
{{Related articles end}}
[https://prometheus.io/ Prometheus] はオープンソースのメトリクス収集・処理ツールです。時系列データベースと保存されているメトリクスにアクセス・処理するクエリ言語から成ります。Prometheus は複数のサービスからメトリクスを収集できます。ミニマルなウェブ UI を備えており、 [[Grafana]] などのサードパーティのツールによるダッシュボードを使うこともできます。

== インストール ==

{{Pkg|prometheus}} パッケージを[[インストール]]してください。その後、{{ic|prometheus}} サービスを[[起動]]・[[有効化]]することで HTTP のポート 9090 からアプリケーションにアクセスできます。

デフォルト設定では自身の {{ic|prometheus}} プロセスを監視します。システムの監視を行うには {{Pkg|prometheus-node-exporter}} をインストールします。ローカルシステムからメトリクスが収集されます。{{ic|prometheus-node-exporter}} サービスを起動・有効化することで使うことができ、デフォルトでポート 9100 が開きます。{{ic|prometheus-node-exporter}} サービスが起動したら、これを定期的にスクレイピングするよう Prometheus の設定をすることにより、実際にデータが収集できるようになります。これは後述の手順 [[#メトリクスの追加|メトリクスの追加]] に従って行います。
{{Warning|デフォルト設定の場合 {{ic|prometheus}} は {{ic|*:9090}} を、 {{ic|prometheus-node-exporter}} は {{ic|*:9100}} を listen します。そのため、忘れずに設定変更、もしくは、対応するファイアウォールのルールを有効にしてください。また、[https://prometheus.io/docs/operating/security/ Prometheus security model] もあわせて確認してください。}}

== 設定 ==

Prometheus の設定は [[Wikipedia:YAML|YAML]] を使用し、メインの設定ファイルは {{ic|/etc/prometheus/prometheus.yml}} です。

=== メトリクスの追加 ===

{{ic|scrape_configs}} 配列にメトリクスの収集先を追加することができます。ソースとしてローカルのノードエクスポータを追加したい場合、設定は以下のようになります:

scrape_configs:
- job_name: 'prometheus'
static_configs:
- targets: ['localhost:9090']
- job_name: 'localhost'
static_configs:
- targets: ['localhost:9100']

=== エクスポーター ===
Arch Linuxのリポジトリには [https://prometheus.io/docs/instrumenting/exporters/ 利用可能なエクスポーター] の一部が登録されています:

* {{Pkg|prometheus-node-exporter}} - システムのメトリクス
* {{Pkg|prometheus-blackbox-exporter}} - エンドポイント（HTTP, HTTPS, DNS, TCP, ICMP）に対するブラックボックス探査
* {{Pkg|prometheus-memcached-exporter}} - {{ic|memcached}} のメトリクス
* {{Pkg|prometheus-mysqld-exporter}} - MySQLサーバーのメトリクス

各エクスポーターはサービスの形で実現されています。例えば node exporter を実行する場合は {{ic|prometheus-node-exporter.service}} を [[起動]] ・ [[有効化]] します。

== UI を使う ==

Prometheus には設定を確認したりメトリクスにアクセス・グラフ化するための限定的な UI が付属しています。デフォルトでは http://localhost:9090 から使用できます。Prometheus のクエリ言語について詳しくは [https://prometheus.io/docs/prometheus/latest/querying/basics/ Prometheus のドキュメント] を参照してください。

== 参照 ==
* [https://prometheus.io/ 公式ホームページ]

Prometheus

2021-10-23T09:30:45Z

Hirsak13: →インストール: 英語版で追加された記述を翻訳

Prometheus

2021-10-23T07:28:47Z

Hirsak13: →インストール: 英語版で削除された記述に追従

Prometheus

2021-10-23T06:02:24Z

Hirsak13: 関連記事を追加(英語版に追従)

ArchWiki:サンドボックス

2021-10-17T12:06:48Z

Hirsak13: ''→インストールガイド(要約の書き方の確認): :en:Special:PermanentLink/698312''

test
<pre>do not use this</pre>arch linux{{bc|use this}}テストオンライン

テスト

''[[インストールガイド|→インストールガイド(要約の書き方の確認)]]: [[:en:Special:PermanentLink/698312]]''

ArchWiki:サンドボックス

2021-10-17T11:52:56Z

Hirsak13: ''→インストールガイド(要約の書き方の確認): Special:PermanentLink/698312''

test
<pre>do not use this</pre>arch linux{{bc|use this}}テストオンライン

テスト

''[[インストールガイド|→インストールガイド(要約の書き方の確認)]]: [[Special:PermanentLink/698312]]''

ArchWiki:サンドボックス

2021-10-17T10:28:46Z

Hirsak13: ''→インストールガイド(要約の書き方の確認): [https://wiki.archlinux.org/title/Special:PermanentLink/698312 en:Special:PermanentLink/698312]''

test
<pre>do not use this</pre>arch linux{{bc|use this}}テストオンライン

テスト

''[[インストールガイド|→インストールガイド(要約の書き方の確認)]]: [https://wiki.archlinux.org/title/Special:PermanentLink/698312 en:Special:PermanentLink/698312]''

ArchWiki:サンドボックス

2021-10-17T09:58:22Z

Hirsak13: 要約内に記載の内部リンクの挙動確認内部リンクの挙動確認

test
<pre>do not use this</pre>arch linux{{bc|use this}}テストオンライン

テスト

[[インストールガイド#インストールの準備|内部リンクの挙動確認]]

利用者:Hirsak13

2021-10-13T15:11:03Z

Hirsak13: 利用者ページを新規作成

=== 編集傾向 ===
翻訳経験はありませんが興味だけはあります。自分にもできそうなところから手を付けていけたらと思っています。