エラー

説明

クエリ処理中に発生したエラーは、標準出力に印刷されます。特定の種類のエラーは、統合されて一定の期間に一度印刷できます。

このプラグインは、サーバーブロックごとに一度だけ使用できます。

構文

基本構文は次のとおりです。

errors

拡張構文で追加のノブを使用できます。

errors {
	stacktrace
	consolidate DURATION REGEXP [LEVEL]
}

オプション stacktrace は、パニック回復中にスタックトレースをログ記録します。

オプション consolidate を使用すると、正規表現 REGEXP に一致する複数のエラーメッセージを DURATION 間収集できます。最初のメッセージを受信してから DURATION 経過すると、統合されたメッセージがオプションのオプション LEVEL で構成可能なログレベルで標準出力に印刷されます。 LEVEL オプションでサポートされるオプションは、warning、error、info、および debug です。

2 errors like '^read udp .* i/o timeout$' occurred in last 30s

異なる DURATION と REGEXP を使用した複数の consolidate オプションが許可されます。エラーメッセージが定義済みの正規表現の複数と一致する場合、メッセージは最初の適切な REGEXP と関連付けられます。

パフォーマンスを向上させるために、エラーメッセージをプレフィックスまたはサフィックスでフィルタリングする場合、正規表現で ^ または $ メタ文字を使用することをお勧めします（例: ^failed to .*、または .* timeout$）。

例

**whoami** を使用して example.org ドメインのクエリに応答し、エラーを標準出力にログ記録します。

example.org {
    whoami
    errors
}

**forward** プラグインを使用して 8.8.8.8 経由でクエリを解決し、サフィックス " i/o timeout" のエラーの統合されたメッセージを警告として、プレフィックス "Failed to " のエラーをエラーとして印刷します。

. {
    forward . 8.8.8.8
    errors {
        consolidate 5m ".* i/o timeout$" warning
        consolidate 30s "^Failed to .+"
    }
}