プレビュー
この機能はまだ開発中ですが、ぜひお試しください。
これは、2021 年 10 月にリリースされた0.0.5以降のバージョンにのみ適用されます。
この機能は現在、弊社のプレリリース ポリシーに従ってプレビュー プログラムの一部として提供されています。
当社のPowerDNS インテグレーション は、 PowerDNS からディメンションメトリクスを収集して送信します。この メトリクスデータ を事前に構築されたダッシュボードで表示したり、アラートポリシーを作成したり、カスタムクエリやチャートを作成したりすることができます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社のインテグレーションは、PowerDNS RecursorおよびAuthoritative Serverと互換性があります。
統合をインストールする前に、次の要件を満たしていることを確認してください。
- インフラストラクチャ・エージェントをインストールする 、最小バージョン1.19.2。
- Linux ディストリビューション インフラストラクチャ・エージェントと互換性がある.
PowerDNS インフラストラクチャからデータを取得するために、PowerDNS 統合ではサードパーティの Prometheus エクスポータを使用します。これにより、構成で指定されたポートで Prometheus メトリクスが公開されます。この統合は、これらのメトリクスを収集し、エンティティに変換し、フィルタリングして、New Relic に送信します。
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の有効化
インストールしてアクティブ化する
PowerDNSインテグレーションをインストールするには、セットアップを選択します。
このドキュメントはインストールの役に立ちましたか?
統合を構成する
統合を構成するには、統合のYAML構成ファイルpowerdns-config.yml
の構成を編集します。
YAML設定を使用して、必要なログイン認証情報を配置し、セットアップと設定に応じてデータの収集方法を設定します。
この統合はプロメテウスエクスポーターに基づいているため、 interval
、 timeout
、 inventory_source
などの他の統合に適用できる設定はサポートされていません。
PowerDNSインスタンスの設定
次の構成オプションを使用できます。
設定 | 説明 | デフォルト |
---|---|---|
powerdns_url | powerdnsサービスのAPI URL | 該当なし |
exporter_port | スクラップエンドポイントを公開するポート。これが提供されない場合、エクスポーターを起動する際にランダムなポートが使用されます。 | ランダムポート |
scrape_timeout | スクレイプリクエストがタイムアウトするまでの時間 | 5s |
api_key | PowerDNSサーバーへの接続に使用するAPIキー | 該当なし |
構成例
データを見つけて使用する
データを検索して使用する方法の詳細については、統合データについてを参照してください。
指標は、エンティティPOWERDNS_AUTHORITATIVE
とPOWERDNS_RECURSOR
の指標サンプルとイベントタイプに添付されます。トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
メトリックデータ
POWERDNS_AUTHORITATIVE
とPOWERDNS_RECURSOR
の 2 つのエンティティが作成されます。
次のディメンションメトリックは、エクスポーターをスクレイピングしてキャプチャされ、エンティティPOWERDNS_AUTHORITATIVE
にリンクされます。
名前 | 説明 | ディメンション |
---|---|---|
| デーモンのアップタイムを秒単位で表したもの。 |
|
| パケットキャッシュのエントリー数。 | |
| ステータス別の再帰的なクエリの合計数。 |
|
| リモートサーバーのIPアドレスです。 |
|
|
| |
| エラーごとの例外の合計数。 |
|
| パケットがPowerDNS内で過ごす平均マイクロ秒数。 | |
| ステータス別のDNS更新クエリの総件数。 |
|
| データベースの注意を待っているパケットの数。 | |
| rcodeの配布。 |
|
| シグネチャーキャッシュのエントリー数。 | |
| 私たちが権威を持たないドメインへの問い合わせ。 |
|
| プロトコルで送信されたアンサーバイトの合計数。 |
|
| UDPクエリーの受信 |
|
| PowerDNSのJSON統計情報の解析中に発生したエラーの数。 | |
| タイプ別メンテナンスのため、キャッシュアクションを延期。 |
|
| PowerDNSの最後のスクレイピングに成功しました。 | |
| 結果によるクエリキャッシュの検索。 |
|
| キーキャッシュのエントリー数。 | |
| プロトコル別の総回答数 |
|
| 結果によるパケットキャッシュの検索。 |
|
| メタデータ・キャッシュのエントリ数。 | |
| プロトコル別のクエリの総数 |
|
| ユーザー空間とカーネル空間で使われたCPUミリ秒数。 |
|
| DNSSECのカウンターです。 |
|
| 回答のサイズ分布 |
|
| 現在のPowerDNSのスクレイプ総数 | |
| リモートホストが、私たちが権威を持たないドメインに問い合わせをすること。 |
|
次のディメンションメトリックは、エクスポーターをスクレイピングしてキャプチャされ、エンティティPOWERDNS_RECURSOR
にリンクされます。
名前 | 説明 | ディメンション |
---|---|---|
| ネットワーク別の受信クエリの総数 |
|
| ネットワーク別の送信クエリの総数。 |
|
| キャッシュのエントリー数。 | |
| 結果別のキャッシュルックアップの合計数。 |
|
| PowerDNSのJSON統計情報の解析中に発生したエラーの数。 | |
| 回答コード別の総回答数 |
|
| 現在のPowerDNSのスクレイプ総数 | |
| 同時実行可能なクエリの数 | |
| 回答時間帯ごとにグループ化された回答の総数。 |
|
| 質問と回答の待ち時間の指数移動平均。 | |
| エラーごとの例外の合計数。 |
|
| PowerDNS のリカーサー応答時間のヒストグラム(秒単位)。(sum metric) | |
| PowerDNS のリカーサー応答時間のヒストグラム(秒)。(バケットメトリック) |
|
| PowerDNSの最後のスクレイピングに成功しました。 |
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。これは、そのソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできることを意味します。
さらに、この統合では、コミュニティが作成したオープンソースのエクスポーターを活用しています。