メトリクスの使用
CPU やメモリの使用量や内部メトリクスなどのメトリクスを使うと、下記を含む多くの機能によりサーバーの管理やデバッグがしやすくなります。
-
インシデントや異常な動作の迅速な検出
-
コンピューティング リソースの動的なスケーリング
-
インフラ全体の問題をさかのぼって把握
メトリクスの収集
スコープ
CircleCI Server では、システムのヘルス状態の監視や、システムの問題のデバッグに役立つ各種メトリクスとログをデフォルトで収集します。
Telegraf
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.