説明
このプラグインは CNAME の解決を試行し、結果の A または AAAA アドレスのみを返します。A または AAAA レコードが解決されない場合、元の (最初の) 応答がクライアントに返されます。
循環依存関係が検出され、それに応じたエラーがログに記録されます。その場合も、元の (最初の) 応答がクライアントに返されます。
構文
finalize [max_depth MAX]
-
max_depthMAX は、CNAME チェーンを最終的な A または AAAA レコードに解決するための最大呼び出し回数を制限します。値> 0を指定できます。最大の深さに到達し、A または AAAA レコードが見つからない場合、CNAME を含む元の (最初の) 応答がクライアントに返されます。
メトリック
モニタリングが有効になっている場合 ( prometheus ディレクティブ経由)、次のメトリックがエクスポートされます。
-
coredns_finalize_request_count_total{server}- finalize プラグインに対するクエリ数。 -
coredns_finalize_circular_reference_count_total{server}- 検出された循環参照の数。 -
coredns_finalize_dangling_cname_count_total{server}- 解決できなかった CNAME の数。 -
coredns_finalize_maxdepth_reached_count_total{server}- CNAME を解決しようとしているときに最大深度に達したインシデントの数。 -
coredns_finalize_maxdepth_upstream_error_count_total{server}- 受信されたアップストリームエラーの数。 -
coredns_finalize_request_duration_seconds{server}- CNAME の解決ごとの時間。
server ラベルは、リクエストを処理したサーバーを示します。
準備完了
このプラグインは、準備状況のプラグインに準備状況を報告します。すぐに準備が整います。
例
この構成では、すべてのクエリを 9.9.9.9 に転送し、CNAME を解決します。
. {
forward . 9.9.9.9
finalize
}
この構成では、すべてのクエリを 9.9.9.9 に転送し、検索の最大深度は 1 で CNAME を解決します。
. {
forward . 9.9.9.9
finalize max_depth 1
}