メリット

インストール

設定

例

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/kubernetes-proxy
    type: kubernetes-proxy
    ... # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
   pipelines:
     metrics:
       receivers: [smartagent/kubernetes-proxy]

例Kubernetesオブザーバー

以下はYAMLコンフィギュレーションの例です：

receivers:
  smartagent/kubernetes-proxy:
    type: kubernetes-proxy
    host: localhost
    port: 10249
    extraDimensions:
      metric_source: kubernetes-proxy

OpenTelemetry Collector には、Kubernetes オブザーバー（k8sobserver）があり、Kubernetes ポッドなどのネットワーク化されたエンドポイントを検出するための拡張機能として実装できます。このオブザーバーを使用する場合、OpenTelemetry Collector がホストモニタリング（エージェント）モードで展開され、個々のノードまたはホストインスタンスで実行されていることを前提としています。

オブザーバーを使用するには、関連するルールを持つレシーバクリエータのインスタンスを作成する必要があります。例：

extensions:
  # Configures the Kubernetes observer to watch for pod start and stop events.
  k8s_observer:
  host_observer:

receivers:
  receiver_creator/1:
    # Name of the extensions to watch for endpoints to start and stop.
    watch_observers: [k8s_observer]
    receivers:
      smartagent/kubernetes-kubeproxy:
        rule: type == "pod" && name matches "kube-proxy"
        type: kubernetes-proxy
        port: 10249
        extraDimensions:
          metric_source: kubernetes-proxy

      prometheus_simple:
        # Configure prometheus scraping if standard prometheus annotations are set on the pod.
        rule: type == "pod" && annotations["prometheus.io/scrape"] == "true"
        config:
          metrics_path: '`"prometheus.io/path" in annotations ? annotations["prometheus.io/path"] : "/metrics"`'
          endpoint: '`endpoint`:`"prometheus.io/port" in annotations ? annotations["prometheus.io/port"] : 9090`'

      redis/1:
        # If this rule matches an instance of this receiver will be started.
        rule: type == "port" && port == 6379
        config:
          # Static receiver-specific config.
          password: secret
          # Dynamic configuration value.
          collection_interval: `pod.annotations["collection_interval"]`
      resource_attributes:
          # Dynamic configuration value.
          service.name: `pod.labels["service_name"]`

      redis/2:
        # Set a resource attribute based on endpoint value.
        rule: type == "port" && port == 6379
        resource_attributes:
          # Dynamic value.
          app: `pod.labels["app"]`
          # Static value.
          source: redis

  receiver_creator/2:
    # Name of the extensions to watch for endpoints to start and stop.
    watch_observers: [host_observer]
    receivers:
      redis/on_host:
        # If this rule matches, an instance of this receiver is started.
        rule: type == "port" && port == 6379 && is_ipv6 == true
        resource_attributes:
          service.name: redis_on_host

processors:
  exampleprocessor:

exporters:
  exampleexporter:

service:
  pipelines:
    metrics:
      receivers: [receiver_creator/1, receiver_creator/2]
      processors: [exampleprocessor]
      exporters: [exampleexporter]
  extensions: [k8s_observer, host_observer]

詳しくは「Receiver creator」 を参照してください。

コンフィギュレーション設定

メトリクス

このインテグレーションでは、以下のメトリクスを使用できます：

備考

デフォルト以外のメトリクス（バージョン 4.7.0 以降）

デフォルトではないメトリクスを出力するには、汎用モニターレベルの extraMetrics 設定オプションでそれらのメトリクスを追加します。上記のメトリクスのリストに表示されない特定の設定オプションから派生したメトリクスは、 extraMetrics に追加する必要はありません。

実行中のエージェントインスタンスでこのモニターを設定した後、agent-status monitors を実行すると、発行されるメトリクスのリストを見ることができます。

トラブルシューティング