メトリクスをPrometheusに直接エクスポートする

最終公開日 : Oct 02, 2026
NetScaler Ingress Controllerは、NetScalerからPrometheusへメトリクスを直接エクスポートすることをサポートするようになりました。 NetScaler Ingress Controllerを使用すると、メトリクスを直接エクスポートするためにNetScalerで必要となる構成を自動化できます。
メトリクスをエクスポートすると、Grafanaなどのツールを使用して、エクスポートされたNetScalerメトリクスを視覚化し、より簡単に解釈および理解できるようになります。

NetScaler CPXからPrometheusへのメトリクスの直接エクスポートを構成する

NetScaler Ingress ControllerがNetScaler CPXを構成して、Prometheusへのメトリクスの直接エクスポートをサポートできるようにするには、次の手順を実行する必要があります。
  1. ユーザーの読み取り専用アクセスを有効にするKubernetesシークレットを作成します。この手順は、NetScaler CPXがメトリクスをPrometheusにエクスポートするために必要です。
    kubectl create secret generic prom-user --from-literal=username=<prometheus-username> --from-literal=password=<prometheus-password>
  2. 次のHelmコマンドを使用して、NetScaler Ingress ControllerでNetScaler CPXを展開します。
    helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/

    helm install my-release netscaler/netscaler-cpx-with-ingress-controller --set license.accept=yes,nsic.prometheusCredentialSecret=<Secret-for-read-only-user-creation>,analyticsConfig.required=true,analyticsConfig.timeseries.metrics.enable=true,analyticsConfig.timeseries.port=5563,analyticsConfig.timeseries.metrics.mode=prometheus,analyticsConfig.timeseries.metrics.enableNativeScrape=true
    コマンドで指定された新しいパラメーターは、次のとおりです。
    • nsic.prometheusCredentialSecret: ネイティブPrometheusサポート用の読み取り専用ユーザーを作成するためのKubernetesシークレット名を指定します。
    • analyticsConfig.timeseries.metrics.enableNativeScrape: メトリクスをPrometheusに直接エクスポートするには、この値をtrueに設定します。
  3. Prometheusの展開に応じて、Prometheus構成のscrape_configsの下に適切なPrometheusスクレイプジョブを追加します。
    • PrometheusサーバーがKubernetesクラスターの外部にある場合は、Prometheus構成のscrape_configsの下にスクレイプジョブを追加します。Prometheusスクレイプジョブの例については、Prometheus統合ドキュメントを参照してください。
    • Prometheusサーバーが同じKubernetesクラスター内にある場合は、NetScaler CPXポッドから直接エクスポートするようにPrometheusを構成するための新しいPrometheusジョブを追加します。詳細については、kubernetes_sd_configを参照してください。Prometheusジョブの例を次に示します。

    - job_name: 'kubernetes-cpx'
      scheme: http
      metrics_path: /nitro/v1/config/systemfile
      params:
        args: ['filename:metrics_prom_ns_analytics_time_series_profile.log,filelocation:/var/nslog']
        format: ['prometheus']
      basic_auth:
        username:  # Prometheus username set in nsic.prometheusCredentialSecret
        password:  # Prometheus password set in nsic.prometheusCredentialSecret
      scrape_interval: 30s
      kubernetes_sd_configs:
      - role: pod
      relabel_configs:
      - source_labels: [__meta_kubernetes_pod_annotation_netscaler_prometheus_scrape]
        action: keep
        regex: true
      - source_labels: [__address__, __meta_kubernetes_pod_annotation_netscaler_prometheus_port]
        action: replace
        regex: ([^:]+)(?::\d+)?;(\d+)
        replacement: $1:$2
        target_label: __address__
      - source_labels: [__meta_kubernetes_namespace]
        action: replace
        target_label: kubernetes_namespace
      - source_labels: [__meta_kubernetes_pod_name]
        action: replace
        target_label: kubernetes_pod_name
注:
Prometheus統合の詳細については、NetScaler Prometheus統合ドキュメントを参照してください。

NetScaler VPX または NetScaler MPX から Prometheus へのメトリクスの直接エクスポートの構成

NetScaler Ingress Controller が NetScaler VPX または NetScaler MPX を構成して、Prometheus へのメトリクスの直接エクスポートをサポートできるようにするには、次の手順を実行する必要があります。
  1. Helm コマンドを使用して、NetScaler Ingress Controller をスタンドアロンポッドとして展開します。
        helm repo add netscaler https://netscaler.github.io/netscaler-helm-charts/

       helm install my-release netscaler/netscaler-ingress-controller --set nsIP=<NSIP>,license.accept=yes,adcCredentialSecret=<Secret-for-NetScaler-credentials>,analyticsConfig.required=true,analyticsConfig.timeseries.metrics.enable=true,analyticsConfig.timeseries.port=5563,analyticsConfig.timeseries.metrics.mode=prometheus,analyticsConfig.timeseries.metrics.enableNativeScrape=true
  2. NetScaler VPX 用の読み取り専用アクセスを持つシステムユーザーを作成します。ユーザー作成の詳細については、NetScaler Prometheus 統合ドキュメント を参照してください。
  3. Prometheus が NetScaler VPX からスクレイピングできるように、Prometheus 構成 の scrape_configs にスクレイプジョブを追加します。Prometheus スクレイプジョブの例については、Prometheus 構成 を参照してください。
注:
スクレイプ構成セクションでは、ターゲットのセットと、それらをスクレイプする方法を記述する構成パラメーターを指定します。構成で使用される NetScaler 固有のパラメーターの詳細については、NetScaler ドキュメント を参照してください。