ベータ版機能
この機能は現在オープンベータ版で、2021年10月にリリースされた 0.0.5 からのバージョンにのみ適用されます。
当社のPowerDNS インテグレーション は、 PowerDNS からディメンションメトリクスを収集して送信します。この メトリクスデータ を事前に構築されたダッシュボードで表示したり、アラートポリシーを作成したり、カスタムクエリやチャートを作成したりすることができます。
インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。
互換性および要件
当社のインテグレーションは、PowerDNS RecursorおよびAuthoritative Serverと互換性があります。
インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。
- インフラストラクチャ・エージェントをインストールする 、最小バージョン1.19.2。
- Linux ディストリビューション インフラストラクチャ・エージェントと互換性がある.
このインテグレーションは、Prometheus エクスポーターを介して PowerDNS API をスクレイピングすることでデータを取得します。
APIを有効にするには、ウェブサーバーとHTTP APIを有効にする必要があります。
pdns.confに以下の行を追加します。
api=yesapi-key=changeme
そして再起動すると、以下の例のように動き出すはずです。
curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost | jq .curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1
詳細については、 WebサーバとApiの有効化
重要
ARM64アーキテクチャには対応していません。
インストールと有効化
PowerDNSインテグレーションをインストールするには、セットアップを選択します。
インテグレーションの設定
統合を設定するには、統合のYAML設定ファイルのconfigを編集します。 powerdns-config.yml
.
YAML設定を使用して、必要なログイン認証情報を配置し、セットアップと設定に応じてデータの収集方法を設定します。
この統合はPrometheus Exporterに基づいているため、 interval
, timeout
or inventory_source
のような他の統合に適用される設定はサポートされていません。
PowerDNSインスタンスの設定
PowerDNSインテグレーションは、次元的なメトリクスを収集します。
設定 | 説明 | デフォルト |
---|---|---|
パワーダウンしたURL | powerdnsサービスのAPI URL | 該当なし |
エクスポーター_ポート | スクラップエンドポイントを公開するポート。これが提供されない場合、エクスポーターを起動する際にランダムなポートが使用されます。 | ランダムポート |
api_key | PowerDNSサーバーへの接続に使用するAPIキー | 該当なし |
設定の例
データの検索と使用
データの検索・使用方法の詳細については、 インテグレーションデータを理解するを参照してください。
メトリクスは、Metric サンプルと イベントタイプ エンティティの POWERDNS_AUTHORITATIVE
と POWERDNS_RECURSOR
に添付されます。 このデータを照会して トラブルシューティングの目的で使用したり、 カスタムチャートやダッシュボードを作成したりすることができます 。
メトリックデータ
以下のディメンションメトリクスは、エクスポーターをスクレイピングして取得され、エンティティ POWERDNS_AUTHORITATIVE
にリンクされています。
名前 | 説明 | ディメンション |
---|---|---|
| デーモンのアップタイムを秒単位で表したもの。 |
|
| パケットキャッシュのエントリー数。 | |
| ステータス別の再帰的なクエリの合計数。 |
|
| リモートサーバーのIPアドレスです。 |
|
| PDNS Server Security status based on | |
| エラーごとの例外の合計数。 |
|
| パケットがPowerDNS内で過ごす平均マイクロ秒数。 | |
| ステータス別のDNS更新クエリの総件数。 |
|
| データベースの注意を待っているパケットの数。 | |
| rcodeの配布。 |
|
| シグネチャーキャッシュのエントリー数。 | |
| 私たちが権威を持たないドメインへの問い合わせ。 |
|
| プロトコルで送信されたアンサーバイトの合計数。 |
|
| UDPクエリーの受信 |
|
| PowerDNSのJSON統計情報の解析中に発生したエラーの数。 | |
| タイプ別メンテナンスのため、キャッシュアクションを延期。 |
|
| PowerDNSの最後のスクレイピングに成功しました。 | |
| 結果によるクエリキャッシュの検索。 |
|
| キーキャッシュのエントリー数。 | |
| プロトコル別の総回答数 |
|
| 結果によるパケットキャッシュの検索。 |
|
| メタデータ・キャッシュのエントリ数。 | |
| プロトコル別のクエリの総数 |
|
| ユーザー空間とカーネル空間で使われたCPUミリ秒数。 |
|
| DNSSECのカウンターです。 |
|
| 回答のサイズ分布 |
|
| 現在のPowerDNSのスクレイプ総数 | |
| リモートホストが、私たちが権威を持たないドメインに問い合わせをすること。 |
|
以下のディメンションメトリクスは、エクスポーターをスクレイピングして取得され、エンティティ POWERDNS_RECURSOR
にリンクされています。
名前 | 説明 | ディメンション |
---|---|---|
| ネットワーク別の受信クエリの総数 |
|
| ネットワーク別の送信クエリの総数。 |
|
| キャッシュのエントリー数。 | |
| 結果別のキャッシュルックアップの合計数。 |
|
| PowerDNSのJSON統計情報の解析中に発生したエラーの数。 | |
| 回答コード別の総回答数 |
|
| 現在のPowerDNSのスクレイプ総数 | |
| 同時実行可能なクエリの数 | |
| 回答時間帯ごとにグループ化された回答の総数。 |
|
| 質問と回答の待ち時間の指数移動平均。 | |
| エラーごとの例外の合計数。 |
|
| PowerDNS のリカーサー応答時間のヒストグラム(秒単位)。(sum metric) | |
| PowerDNS のリカーサー応答時間のヒストグラム(秒)。(バケットメトリック) |
|
| PowerDNSの最後のスクレイピングに成功しました。 |
ソースコードのチェック
このインテグレーションは、オープンソース・ソフトウェアです。つまり、 そのソースコードを閲覧して 改良点を送ったり、自分でフォークを作って構築することができます。
さらに、この統合では、コミュニティが作成したオープンソースのエクスポーターを活用しています。