メトリクスの使用

Server v4.x

サーバー管理者

メトリクスの収集

スコープ

CircleCI Server では、システムのヘルス状態の監視や、システムの問題のデバッグに役立つ各種メトリクスとログをデフォルトで収集します。

Telegraf

CircleCI Server 上で実行されるほとんどのサービスは、サーバーで実行されている Telegraf ポッドに StatsD メトリクスを報告します。この設定は完全にカスタマイズ可能で、出力プラグインを介して、Telegraf でサポートされている任意の出力先に Telegraf のメトリクスを転送できます。デフォルトでは、Prometheus で収集するためのメトリクスエンドポイントが提供されます。

Telegraf から Datadog へのメトリクスの転送

以下に、Telegraf から Datadog にメトリクスを出力する設定方法の例を示します。

お客様の CircleCI Server のカスタマイズされた values.yaml には、以下のような Telegraf のセクションが既にある場合があります。以下のセクションがない場合は、追加してください。

...
telegraf:
  args:
    - --config
    - /etc/telegraf/telegraf.d/telegraf_custom.conf
  config:
    custom_config_file: |
      [agent]
        collection_jitter = "0s"
        debug = false
        flush_interval = "10s"
        flush_jitter = "0s"
        hostname = "$HOSTNAME"
        interval = "30s"
        logfile = ""
        metric_batch_size = 1000
        metric_buffer_limit = 10000
        omit_hostname = true
        precision = ""
        quiet = false
        round_interval = true

      [[processors.enum]]
        [[processors.enum.mapping]]
          dest = "status_code"
          field = "status"
          [processors.enum.mapping.value_mappings]
              critical = 3
              healthy = 1
              problem = 2

      [[inputs.statsd]]
        datadog_extensions = true
        metric_separator = "."
        percentile_limit = 1000
        percentiles = [
          50,
          95,
          99
        ]
        service_address = ":8125"
      [[inputs.internal]]
        collect_memstats = false

      [[outputs.file]]
        files = ["stdout"]

      [[outputs.prometheus_client]]
        listen = ":9273"
        path = "/metrics"
...

helm values.yaml の telgraf.config.custom_config_file のブロックの下部に、 "my-secret-key" をお客様の Datadog API キーに置き換えてを以下のように追加します。

telegraf:
  config:
    custom_config_file: |
      ...
      [[outputs.datadog]]
        ## Replace "my-secret-key" with Datadog API key
        apikey = "my-secret-key"
      ...

詳細については、 Telegraf のドキュメントを参照してください。

最後に、Helm の更新により変更を適用する必要があります。

helm upgrade circleci-server oci://cciserver.azurecr.io/circleci-server -n <namespace> --version <version> -f <path-to-values.yaml> --username $USERNAME --password $PASSWORD

注: Helm のアッププレード後に Telegraf ポッドが再起動しない場合、変更は有効になりません。以下のコマンドにより、Telegraf インスタンスを安全に再起動できます。ダウンタイムを発生させずに、Telegraf を再起動します。

kubectl rollout restart deploy telegraf -n <namespace>

次のステップ

ユーザーアカウントの管理ガイドをお読みください。

ドキュメントの改善にご協力ください

このガイドは、CircleCI の他のドキュメントと同様にオープンソースであり、 GitHub でご利用いただけます。ご協力いただき、ありがとうございます。

このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。フィードバックをお寄せいただける場合は、リサーチコミュニティにご参加ください。

サポートが必要ですか

CircleCI のサポートエンジニアによる、サービスに関する問題、請求およびアカウントについての質問への対応、設定の構築に関する問題解決のサポートを行っています。サポートチケットを送信して、CircleCI のサポートエンジニアにお問い合わせください。日本語でお問い合わせいただけます。

または、サポートサイトから、サポート記事やコミュニティフォーラム、トレーニングリソースをご覧いただけます。

CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.