第4章 Load-balancing サービスインスタンスのログの管理
Load-balancing サービス (octavia) インスタンス (amphora) は、管理ログとテナントフローログを生成します。amphora は、これらのログをコンテナーのセットを使用して syslog レシーバーの中央ロケーションへオフロードするか、または選択可能なエンドポイント上の別の syslog レシーバーへオフロードします。このログのオフロード機能により、管理者はログを 1 カ所で管理し、amphora のローテーション時にログを維持することができます。
ログオフロードはデフォルトで有効になっていますが、amphora は引き続き amphora 内のディスクに管理フローログおよびテナントフローログの書き込みを続行します。ただし、選択した場合は、ローカルでロギングを無効にすることができます。
TCP syslog プロトコルを使用する場合、プライマリーエンドポイントに障害が発生した場合に、管理ログとテナントログのオフロード用に 1 つ以上のセカンダリーエンドポイントを指定できます。
syslog ファシリティー値の設定、テナントフローログの形式の変更、カーネルなどのソースからのログや cron からログを含めるよう管理ロギングの範囲を拡張するなど、その他のロギング機能の範囲を制御できます。
4.1. Load-balancing サービスインスタンスのロギングの設定パラメーター リンクのコピーリンクがクリップボードにコピーされました!
Load-balancing サービス (octavia) インスタンス (amphora) ロギング設定を変更するには、ロギングを制御する 1 つ以上の設定パラメーターに値を設定し、Load-balancing サービスに OpenStackControlPlane カスタムリソース (CR) を適用します。
amphora ロギングのこれらの設定パラメーターにより、ログオフロードの無効化、ログをオフロードするカスタムエンドポイントの定義、ログの syslog ファシリティー値の設定などの機能を制御できます。
octavia Operator は、ログオフロードを自動的に有効にします。
- グローバルロギングパラメーター
-
すべてのログの設定パラメーターを設定するには、octavia サービスごとに特定のセクション (ハウスキーピング、ヘルスマネージャー、およびワーカー) を
OpenStackControlerPlaneCR に追加する必要があります。customServiceConfig.[amphora_agent]パラメーターの下にあるすべてのログの設定パラメーターを追加します。 - 使用例:
octavia:
template:
octaviaHousekeeping:
customServiceConfig: |
[amphora_agent]
<log configuration parameters go here>
octaviaHealthManager:
customServiceConfig: |
[amphora_agent]
<log configuration parameters go here>
octaviaWorker:
customServiceConfig: |
[amphora_agent]
<log configuration parameters go here>
disable_local_log_storage=false-
trueの場合、インスタンスはインスタンスのホストのファイルシステムにログを格納しません。これには、すべてのカーネル、システム、およびセキュリティーログが含まれます。デフォルトはfalseです。 forward_all_logs=true-
trueの場合、インスタンスはすべてのログメッセージを管理ログのエンドポイントに転送します。これには、cron やカーネルログなどの負荷分散に関連しないログも含まれます。Default:true
- 管理ロギングパラメーター
-
管理ロギングの設定パラメーターを設定するには、octavia サービスごとに特定のセクション (ハウスキーピング、ヘルスマネージャー、およびワーカー) を
OpenStackControlerPlaneCR に追加する必要があります。adminLogTargetsを除き、管理ロギングの設定パラメーターをcustomServiceConfig.[amphora_agent]パラメーターの下に追加します。 - 使用例:
octavia:
template:
octaviaRsyslog:
adminLogTargets:
- host: 192.168.1.1
port: 1514
protocol: udp
octaviaHousekeeping:
customServiceConfig: |
[amphora_agent]
<administrative logging parameters go here>
octaviaHealthManager:
customServiceConfig: |
[amphora_agent]
<administrative logging parameters go here>
octaviaWorker:
customServiceConfig: |
[amphora_agent]
<administrative logging parameters go here>
adminLogTargets管理ログメッセージを受信する syslog エンドポイントを記述するオブジェクトのリスト
-
host: <host> -
port: <port> protocol: <protocol>エンドポイントは、指定されたポートでログメッセージをリッスンするプロセスを実行しているコンテナー、仮想マシン、または物理ホストのいずれかになります。デフォルト: デフォルト値は octavia Operator によって自動的に設定されます。
octaviaRsyslogパラメーターの下にadminLogTargetsを追加します。
-
administrative_log_facility=<number>-
管理ログメッセージに使用する syslog
LOG_LOCALファシリティーである0から7の間の数字。デフォルト:1。
- テナントフローのロギングパラメーター
-
テナントフローロギングの設定パラメーターを設定するには、octavia サービスごとに特定のセクション (ハウスキーピング、ヘルスマネージャー、およびワーカー) を
OpenStackControlerPlaneCR に追加する必要があります。tenantLogTargetsを除き、customServiceConfig.[amphora_agent]パラメーターの下にテナントフローロギングの設定パラメーターを追加します。これらのパラメーターの設定方法の例は、「Load-balancing サービスインスタンスのテナントフローのロギングの無効化」 を参照してください。 - 使用例:
octavia:
template:
octaviaRsyslog
tenantLogTargets:
- host: 192.168.1.1
port: 1514
protocol: udp
octaviaHousekeeping:
customServiceConfig: |
[amphora_agent]
<tenant flow logging parameters go here>
[haproxy_amphora]
connection_login=true
octaviaHealthManager:
customServiceConfig: |
[amphora_agent]
<tenant flow logging parameters go here>
[haproxy_amphora]
connection_login=true
octaviaWorker:
customServiceConfig: |
[amphora_agent]
<tenant flow logging go here>
[haproxy_amphora]
connection_login=true
connection_login=true | false-
trueの場合、テナント接続フローがログに記録されます。Default:true tenantLogTargetsテナントトラフィックフローログメッセージを受信する syslog エンドポイントを記述するオブジェクトのリスト
-
host: <host> -
port: <port> protocol: <protocol>これらのエンドポイントは、指定されたポートでログメッセージをリッスンするプロセスを実行しているコンテナー、仮想マシン、または物理ホストになります。デフォルト: デフォルト値は octavia Operator によって自動的に設定されます。
octaviaRsyslogパラメーターの下にtenantLogTargetsを追加します。
-
user_log_facility=<number>-
テナントトラフィックフローログメッセージに使用する syslog "LOG_LOCAL" ファシリティーである 0 から 7 の間の数字。デフォルト:
0。 user_log_format="<value>"テナントトラフィックフローログの形式
デフォルト:
"{{ '{{' }} project_id {{ '}}' }} {{ '{{' }} lb_id {{ '}}' }} %f %ci %cp %t %{+Q}r %ST %B %U %[ssl_c_verify] %{+Q}[ssl_c_s_dn] %b %s %Tt %tsc"。英数字は特定の octavia フィールドを表し、中括弧 ({}) は置換変数です。