parca agent
v0.35.0
Parca Agent は、eBPF を使用して生のプロファイリング データを非常に低いオーバーヘッドでキャプチャする常時稼働のサンプリング プロファイラです。ユーザー空間とカーネル空間のスタックトレースを 1 秒あたり 19 回監視し、抽出されたデータから pprof 形式のプロファイルを構築します。詳細については、設計ドキュメントを参照してください。
収集されたデータは、HTTP エンドポイントを介してローカルで表示でき、その後 Parca サーバーに送信され、時間の経過とともにクエリおよび分析されるように構成できます。
「Kubernetes 入門」を参照してください。
Parca Agent は、複数言語のサポートを継続的に強化しています。現在サポートされている言語の不完全なリスト:
詳細については、ドキュメントを参照してください。
注記
今後数週間から数か月以内に、さらなる言語サポートが提供される予定です。
利用可能なプロファイルの種類:
注記
お使いの言語がサポートされているかどうかは、ドキュメントを確認してください。
次のタイプのプロファイルには、明示的なインストルメンテーションが必要です。
潜在的なエラーをデバッグするには、 --log-level=debug使用してデバッグ ログを有効にします。
Usage: parca-agent
Flags:
-h, --help Show context-sensitive help.
--log-level="info" Log level.
--log-format="logfmt" Configure if structured logging as JSON or as
logfmt
--http-address="127.0.0.1:7071"
Address to bind HTTP server to.
--version Show application version.
--node="hostname" The name of the node that the process is
running on. If on Kubernetes, this must match
the Kubernetes node name.
--config-path="" Path to config file.
--memlock-rlimit=0 The value for the maximum number of bytes
of memory that may be locked into RAM. It is
used to ensure the agent can lock memory for
eBPF maps. 0 means no limit.
--mutex-profile-fraction=0
Fraction of mutex profile samples to collect.
--block-profile-rate=0 Sample rate for block profile.
--profiling-duration=10s The agent profiling duration to use. Leave
this empty to use the defaults.
--profiling-cpu-sampling-frequency=19
The frequency at which profiling data is
collected, e.g., 19 samples per second.
--profiling-perf-event-buffer-poll-interval=250ms
The interval at which the perf event buffer
is polled for new events.
--profiling-perf-event-buffer-processing-interval=100ms
The interval at which the perf event buffer
is processed.
--profiling-perf-event-buffer-worker-count=4
The number of workers that process the perf
event buffer.
--metadata-external-labels=KEY=VALUE;...
Label(s) to attach to all profiles.
--metadata-container-runtime-socket-path=STRING
The filesystem path to the container runtimes
socket. Leave this empty to use the defaults.
--metadata-disable-caching
Disable caching of metadata.
--local-store-directory=STRING
The local directory to store the profiling
data.
--remote-store-address=STRING
gRPC address to send profiles and symbols to.
--remote-store-bearer-token=STRING
Bearer token to authenticate with store
( $ PARCA_BEARER_TOKEN).
--remote-store-bearer-token-file=STRING
File to read bearer token from to
authenticate with store.
--remote-store-insecure Send gRPC requests via plaintext instead of
TLS.
--remote-store-insecure-skip-verify
Skip TLS certificate verification.
--remote-store-batch-write-interval=10s
Interval between batch remote client writes.
Leave this empty to use the default value of
10s.
--remote-store-rpc-logging-enable
Enable gRPC logging.
--remote-store-rpc-unary-timeout=5m
Maximum timeout window for unary gRPC
requests including retries.
--debuginfo-directories=/usr/lib/debug,...
Ordered list of local directories to search
for debuginfo files.
--debuginfo-temp-dir="/tmp"
The local directory path to store the interim
debuginfo files.
--debuginfo-strip Only upload information needed for
symbolization. If false the exact binary the
agent sees will be uploaded unmodified.
--debuginfo-compress Compress debuginfo files' DWARF sections
before uploading.
--debuginfo-upload-disable
Disable debuginfo collection and upload.
--debuginfo-upload-max-parallel=25
The maximum number of debuginfo upload
requests to make in parallel.
--debuginfo-upload-timeout-duration=2m
The timeout duration to cancel upload
requests.
--debuginfo-upload-cache-duration=5m
The duration to cache debuginfo upload
responses for.
--debuginfo-disable-caching
Disable caching of debuginfo.
--symbolizer-jit-disable Disable JIT symbolization.
--otlp-address=STRING The endpoint to send OTLP traces to.
--otlp-exporter="grpc" The OTLP exporter to use.
--object-file-pool-eviction-policy="lru"
The eviction policy to use for the object
file pool.
--object-file-pool-size=100
The maximum number of object files to keep in
the pool. This is used to avoid re-reading
object files from disk. It keeps FDs open,
so it should be kept in sync with ulimits.
0 means no limit.
--dwarf-unwinding-disable Do not unwind using .eh_frame information.
--dwarf-unwinding-mixed Unwind using .eh_frame information and frame
pointers.
--python-unwinding-disable
Disable Python unwinder.
--ruby-unwinding-disable Disable Ruby unwinder.
--analytics-opt-out Opt out of sending anonymous usage
statistics.
--telemetry-disable-panic-reporting
--telemetry-stderr-buffer-size-kb=4096
--bpf-verbose-logging Enable verbose BPF logging.
--bpf-events-buffer-size=8192
Size in pages of the events buffer.
--verbose-bpf-logging [deprecated] Use --bpf-verbose-logging.
Enable verbose BPF logging.Parca Agent は Prometheus の再ラベル付けをサポートしています。次のラベルが常にプロファイルに付加されます。
node : --nodeフラグで指定された、プロセスが実行されているノードの名前。comm : プロファイリングされるプロセスのコマンド名。また、オプションで--metadata-external-labelsフラグを使用して追加のラベルを添付できます。
再ラベルを使用すると、次のラベルをプロファイルに添付できます。
__meta_process_pid : プロファイリングされているプロセスのプロセス ID。__meta_process_cmdline : プロファイリングされるプロセスのコマンド ライン引数。__meta_process_cgroup : プロファイリングされるプロセスの (メイン) cgroup。__meta_process_ppid : プロファイリングされるプロセスの親プロセス ID。__meta_process_executable_file_id : プロファイリングされるプロセスの実行可能ファイルのファイル ID (ハッシュ)。__meta_process_executable_name : プロファイリングされるプロセスの実行可能ファイルのベース名。__meta_process_executable_build_id : プロファイリングされるプロセスの実行可能ファイルのビルド ID。__meta_process_executable_compiler : プロファイリングされるプロセスの実行可能ファイルをビルドするために使用されるコンパイラ。__meta_process_executable_static : プロファイリングされているプロセスの実行可能ファイルが静的にリンクされているかどうか。__meta_process_executable_stripped : プロファイリングされているプロセスの実行可能ファイルが debuginfo から削除されるかどうか。__meta_system_kernel_release : システムのカーネル リリース。__meta_system_kernel_machine : システムのカーネル マシン (通常はアーキテクチャ)。__meta_thread_comm : プロファイリングされているスレッドのコマンド名。__meta_thread_id : プロファイリングされているスレッドの PID。__meta_agent_revision : エージェントのリビジョン。__meta_kubernetes_namespace : プロセスが実行されているポッドの名前空間。__meta_kubernetes_pod_name : プロセスが実行されているポッドの名前。__meta_kubernetes_pod_label_* : プロセスが実行されているポッドのラベル*の値。__meta_kubernetes_pod_labelpresent_* : プロセスが実行されているポッドのラベル*が存在するかどうか。__meta_kubernetes_pod_annotation_* : プロセスが実行されているポッドのアノテーション*の値。__meta_kubernetes_pod_annotationpresent_* : プロセスが実行されているポッドのアノテーション*が存在するかどうか。__meta_kubernetes_pod_ip : プロセスが実行されているポッドの IP。__meta_kubernetes_pod_container_name : プロセスが実行されているコンテナーの名前。__meta_kubernetes_pod_container_id : プロセスが実行されているコンテナーの ID。__meta_kubernetes_pod_container_image : プロセスが実行されているコンテナーのイメージ。__meta_kubernetes_pod_container_init : プロセスが実行されているコンテナーが init コンテナーであるかどうか。__meta_kubernetes_pod_ready : プロセスが実行されているポッドの準備ができているかどうか。__meta_kubernetes_pod_phase : プロセスが実行されているポッドのフェーズ。__meta_kubernetes_node_name : プロセスが実行されているノードの名前。__meta_kubernetes_pod_host_ip : プロセスが実行されているポッドのホスト IP。__meta_kubernetes_pod_uid : プロセスが実行されているポッドの UID。__meta_kubernetes_pod_controller_kind : プロセスが実行されているポッドのコントローラーの種類。__meta_kubernetes_pod_controller_name : プロセスが実行されているポッドのコントローラーの名前。__meta_kubernetes_node_label_* : プロセスが実行されているノードのラベル*の値。__meta_kubernetes_node_labelpresent_* : プロセスが実行されているノードのラベル*が存在するかどうか。__meta_kubernetes_node_annotation_* : プロセスが実行されているノードのアノテーション*の値。__meta_kubernetes_node_annotationpresent_* : プロセスが実行されているノードのアノテーション*が存在するかどうか。__meta_docker_container_id : プロセスが実行されているコンテナーの ID。__meta_docker_container_name : プロセスが実行されているコンテナーの名前。__meta_docker_build_kit_container_id : プロセスが実行されているコンテナーの ID。__meta_containerd_container_id : プロセスが実行されているコンテナーの ID。__meta_containerd_container_name : プロセスが実行されているコンテナーの名前。__meta_containerd_pod_name : プロセスが実行されているポッドの名前。__meta_lxc_container_id : プロセスが実行されているコンテナーの ID。 Parca Agent はrootユーザー (またはCAP_SYS_ADMIN ) として実行する必要があります。 Parca Agent を実行しているユーザーを保護するために、さまざまなセキュリティ予防措置が講じられています。詳細については、「セキュリティに関する考慮事項」を参照してください。
セキュリティの脆弱性を報告するには、このガイドを参照してください。
まずは貢献ガイドをご覧ください。
ユーザー空間コード: Apache 2
カーネル空間コード (eBPF プロファイラー): GNU General Public License、バージョン 2
おかげで:
