parca agent

帕卡代理

Parca Agent 是一个始终在线的采样分析器，它使用 eBPF 以非常低的开销捕获原始分析数据。它每秒观察用户空间和内核空间堆栈跟踪 19 次，并根据提取的数据构建 pprof 格式的配置文件。请阅读设计文档中的更多详细信息。

收集到的数据可以通过 HTTP 端点在本地查看，然后配置为发送到 Parca 服务器以便随时间查询和分析。

要求

• 带 BTF 的 Linux 内核版本 5.3+

快速入门

请参阅 Kubernetes 入门。

语言支持

Parca Agent 正在不断增强对多种语言的支持。我们当前支持的语言的不完整列表：

• C、C++、Go（具有扩展支持）、Rust
• .NET、Deno、Erlang、Java、Julia、Node.js、Wasmtime、PHP 8 及更高版本
• 红宝石、Python

请查看我们的文档以获取更多信息。

笔记

未来几周和几个月内将提供更多语言支持。

支持的配置文件

可用的配置文件类型：

• CPU上
• 很快：网络使用、分配

笔记

如果您的语言受支持，请查看我们的文档。

以下类型的配置文件需要显式检测：

• 运行时特定信息，例如 Goroutines

调试

记录

要调试潜在错误，请使用--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 ：进程运行所在的 pod 的命名空间。
• __meta_kubernetes_pod_name ：进程运行所在的 pod 的名称。
• __meta_kubernetes_pod_label_* ：进程运行所在 pod 的标签值* 。
• __meta_kubernetes_pod_labelpresent_* ：进程运行所在的 pod 的标签*是否存在。
• __meta_kubernetes_pod_annotation_* ：进程正在运行的 pod 的注释*的值。
• __meta_kubernetes_pod_annotationpresent_* ：进程运行所在的 pod 的注释*是否存在。
• __meta_kubernetes_pod_ip ：进程运行所在 Pod 的 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 ：进程运行所在的 pod 是否已准备好。
• __meta_kubernetes_pod_phase ：进程运行所在的 pod 阶段。
• __meta_kubernetes_node_name ：进程运行的节点的名称。
• __meta_kubernetes_pod_host_ip ：进程运行所在的 pod 的主机 IP。
• __meta_kubernetes_pod_uid ：进程运行所在的 pod 的 UID。
• __meta_kubernetes_pod_controller_kind ：进程运行所在的 pod 控制器的类型。
• __meta_kubernetes_pod_controller_name ：进程运行所在的 pod 控制器的名称。
• __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 ：进程运行所在的 pod 的名称。
• __meta_lxc_container_id ：进程正在运行的容器的 ID。

安全

Parca Agent 需要以root用户（或CAP_SYS_ADMIN ）身份运行。已采取各种安全预防措施来保护运行 Parca Agent 的用户。请参阅安全注意事项中的详细信息。

要报告安全漏洞，请参阅本指南。

贡献

查看我们的贡献指南以开始！

执照

用户空间代码：Apache 2

内核空间代码（eBPF 分析器）：GNU 通用公共许可证，版本 2

制作人员

由于：

• Kinvolk 创建 Inspektor Gadget；该项目的某些部分受到了其中部分内容的启发。