第3章 クラスターロギング

手順

• KnativeServing および KnativeEventing CR でそれぞれ loglevel 値を設定または変更して、Serving および Eventing のログ設定を構成します。以下に、すべての可能なログオプションをレベル info に設定した 2 つの設定例を示します。

  KnativeServing CR

  apiVersion: operator.knative.dev/v1beta1
  kind: KnativeServing
  metadata:
    name: knative-serving
    namespace: knative-serving
  spec:
    config:
      logging:
        loglevel.controller: "info"
        loglevel.autoscaler: "info"
        loglevel.queueproxy: "info"
        loglevel.webhook: "info"
        loglevel.activator: "info"
        loglevel.hpaautoscaler: "info"
        loglevel.net-certmanager-controller: "info"
        loglevel.net-istio-controller: "info"
        loglevel.net-kourier-controller: "info"

  KnativeEventing CR

  apiVersion: operator.knative.dev/v1beta1
  kind: KnativeEventing
  metadata:
    name: knative-eventing
    namespace: knative-eventing
  spec:
    config:
      logging:
        loglevel.controller: "info"
        loglevel.eventing-webhook: "info"
        loglevel.inmemorychannel-dispatcher: "info"
        loglevel.inmemorychannel-webhook: "info"
        loglevel.mt-broker-controller: "info"
        loglevel.mt_broker_filter: "info"
        loglevel.mt_broker_ingress: "info"
        loglevel.pingsource-mt-adapter: "info"

手順

• KnativeServing CR の observability フィールドを変更して、サービスのリクエストログを設定します。

  KnativeServing CR の例

  apiVersion: operator.knative.dev/v1beta1
  kind: KnativeServing
  metadata:
    name: knative-serving
    namespace: knative-serving
  # ...
  spec:
    config:
      observability:
          logging.enable-request-log: true
          logging.enable-probe-request-log: true
          logging.request-log-template: '{"httpRequest": {"requestMethod": "{{.Request.Method}}", "requestUrl": "{{js .Request.RequestURI}}", "requestSize": "{{.Request.ContentLength}}", "status": {{.Response.Code}}, "responseSize": "{{.Response.Size}}", "userAgent": "{{js .Request.UserAgent}}", "remoteIp": "{{js .Request.RemoteAddr}}", "serverIp": "{{.Revision.PodIP}}", "referer": "{{js .Request.Referer}}", "latency": "{{.Response.Latency}}s", "protocol": "{{.Request.Proto}}"}, "traceId": "{{index .Request.Header "X-B3-Traceid"}}"}'
  # ...

• Request は、サーバーが受け取った HTTP リクエストを表す http.Request です。

• Response は HTTP レスポンスを表し、次のフィールドが含まれます。

  • Code は HTTP ステータスコードです。
  • Size はバイト単位の応答サイズです。
  • Latency は、秒単位での応答レイテンシーです。

• Revision にはリビジョンの詳細が含まれ、次のフィールドが含まれます。

  • Name はリビジョンの名前です。
  • Namespace はリビジョンの namespace です。
  • Service はサービスの名前です。
  • Configuration は設定の名前です。
  • PodName は、リビジョンをホストする Pod の名前です。
  • PodIP はホスティング Pod の IP アドレスです。