ConfigMap を使用した分析構成のサポート

最終公開日 : Oct 02, 2026
NetScaler Observability Exporter を使用して、NetScaler CPX、MPX、またはVPXからメトリクスとトランザクションをエクスポートし、エクスポートされたデータを分析して有意義なインサイトを得ることができます。NetScaler Ingress Controller 内で ConfigMap を使用して、NetScaler Observability Exporter の構成を有効にできるようになりました。
Related information
メトリクス

NS_ANALYTICS_CONFIG のスキーマ

NS_ANALYTICS_CONFIG のスキーマは次のとおりです。ConfigMap の属性は、このスキーマに準拠している必要があります。
type: map
mapping:
  NS_ANALYTICS_CONFIG:
    required: false
    type: map
    mapping:
      endpoint:
        required: false
        type: map
        mapping:
          metrics:
            required: false
            type: map
            mapping:
              service:
                required: false
                type: str
          transactions:
            required: false
            type: map
            mapping:
              service:
                required: false
                type: str
      distributed_tracing:
        required: false
        type: map
        mapping:
          enable:
            required: true
            type: str
            enum:
              - 'true'
              - 'false'
          samplingrate:
            required: false
            type: int
            range:
              max: 100
              min: 0
      timeseries:
        required: false
        type: map
        mapping:
          port:
            required: false
            type: int
          metrics:
            required: false
            type: map
            mapping:
              enable:
                required: true
                type: str
                enum:
                  - 'true'
                  - 'false'
              mode:
                required: true
                type: str
                enum:
                  - prometheus
                  - avro
                  - influx
              export_frequency:
                required: false
                type: int
                range:
                  max: 300
                  min: 30
              schema_file:
                required: false
                type: str
              enable_native_scrape:
                required: false
                type: str
                enum:
                  - 'true'
                  - 'false'
          auditlogs:
            required: false
            type: map
            mapping:
              enable:
                required: true
                type: str
                enum:
                  - 'true'
                  - 'false'
          events:
            required: false
            type: map
            mapping:
              enable:
                required: true
                type: str
                enum:
                  - 'true'
                  - 'false'
      transactions:
        required: false
        type: map
        mapping:
          enable:
            required: true
            type: str
            enum:
              - 'true'
              - 'false'
          port:
            required: false
            type: int
注記:
  • NSIC リリース 2.0.x 以降、endpoint.server パラメータは endpoint.metrics.service パラメータに置き換えられました。
  • NSIC リリース 2.0.x 以降、endpoint.service パラメータは endpoint.transactions.service パラメータに置き換えられました。
  • NSIC Helm チャートバージョン 1.x から 2.x にアップグレードする場合、metrics_endpoint (analyticsConfig.endpoint.server) と transactions_endpoint (analyticsConfig.endpoint.service) の値をメモし、Helm アップグレードで次の設定パラメータを使用してアップグレードします: --set analyticsConfig.endpoint.metrics.service=<metrics_endpoint>,analyticsConfig.endpoint. transactions.service=<transactions_endpoint>。

分析構成用の ConfigMap の作成

Helm チャートまたは NetScaler Operator を使用して、NSIC のインストールまたはアップグレード中に分析構成用の ConfigMap を作成できます。ConfigMap の作成に必要なパラメータについては、構成 を参照してください。
以下は、ConfigMap の values.yaml のサンプルです。サポートされている変数については、ConfigMap を使用した分析構成のサポートされている環境変数 を参照してください。
analyticsConfig:
required: true
distributedTracing:
  enable: true
  samplingrate: 100
endpoint:
  metrics:
    service: "1.1.1.1"
  transactions:
    service: "1.1.1.2"
timeseries:
  port: 5563
  metrics:
    enable: true
    mode: 'prometheus'
    exportFrequency: 30
    schemaFile: schema.json
    enableNativeScrape: false
  auditlogs:
    enable: true
  events:
    enable: true
transactions:
  enable: true
  port: 5557
NetScaler Ingress Controller での ConfigMap サポートの構成方法の詳細については、NetScaler Ingress Controller の ConfigMap サポートの構成 を参照してください。

ConfigMap を使用した分析構成のサポートされている環境変数

ConfigMap を使用して、NS_ANALYTICS_CONFIG の下の次のパラメータを構成できます。
  • distributed_tracing: この変数は NetScaler で OpenTracing を有効または無効にし、次の属性を持ちます。
    • enable: OpenTracingを有効にするには、この値をtrueに設定します。デフォルト値はfalseです。
    • samplingrate: OpenTracingのサンプリングレートをパーセンテージで指定します。デフォルト値は100です。
詳細については、分散トレースを参照してください。
  • endpoint: 可観測性エンドポイントのIPアドレスまたはDNSアドレスを指定します。
    • metrics:
      • service: この値を、可観測性エンドポイントのIPアドレスまたはDNSアドレスとして設定します。
    • transactions:
      • service: この値を、NetScaler Observability ExporterサービスのIPアドレスまたはnamespace/serviceとして設定します。
  • timeseries: NetScalerからの時系列データのエクスポートを有効にします。時系列設定には、次の属性を指定できます。
    • port: 分析サーバーの時系列エンドポイントのポート番号を指定します。デフォルト値は5563です。
    • metrics: NetScalerからのメトリックのエクスポートを有効にします。
      • enable: メトリックの送信を有効にするには、この値をtrueに設定します。デフォルト値はfalseです。
      • mode: メトリックエンドポイントのモードを指定します。指定可能な値はavroとprometheusです。
    • auditlogs: NetScalerからの監査ログデータのエクスポートを有効にします。
      • enable: 監査ログデータを有効にするには、この値をtrueに設定します。デフォルト値はfalseです。
    • events: NetScalerからのイベントのエクスポートを有効にします。
      • enable: イベントのエクスポートを有効にするには、この値をtrueに設定します。デフォルト値はfalseです。
  • transactions: NetScalerからのトランザクションのエクスポートを有効にします。
    • enable: トランザクションの送信を有効にするには、この値をtrueに設定します。デフォルト値はfalseです。
    • port: アナリティクスサーバーのトランザクションエンドポイントのポート番号を指定します。デフォルト値は5557です。
NetScaler Ingress Controllerの実行中に、ConfigMap設定をランタイムで変更できます。
NS_ANALYTICS_CONFIGの属性は、明確に定義されたスキーマに従う必要があります。提供された値がスキーマに準拠していない場合、設定全体が拒否されます。参照については、スキーマファイルns_analytics_config_schema.yamlを参照してください。