コンテンツにスキップ

旧方式の Profiler 注入

Profiler 注入は旧バージョンとの互換性を保つための機能です

新規導入には Flameshot を使用してください。Flameshot ではプロセスごとに計測時間を設定でき、スケジュールに従って、または CPU やメモリの使用量がしきい値に達したときに計測を開始できます。

旧方式の datakit-profiler Sidecar は、Java アプリケーションを async-profiler で、Python アプリケーションを py-spy でサンプリングします。

前提条件

  • DataKit で Profile コレクターが有効になっていること。
  • Pod のセキュリティポリシーで、Sidecar への SYS_PTRACE および SYS_ADMIN capability の追加が許可されていること。

Operator の設定

計測する言語に合わせて admission_inject_v2.profilers を設定します。以下の 2 つのルールは、production 名前空間の Pod を言語別のラベルで選択します。

{
    "admission_inject_v2": {
        "profilers": [
            {
                "name": "legacy-java-profiler",
                "language": "java",
                "namespace_selectors": [
                    "^production$"
                ],
                "label_selectors": [
                    "profiling=async-profiler"
                ],
                "check_annotation": false,
                "image": "pubrepo.guance.com/datakit-operator/async-profiler:0.6.0",
                "envs": {
                    "DK_AGENT_HOST": "datakit-service.datakit.svc.cluster.local",
                    "DK_AGENT_PORT": "9529",
                    "DK_PROFILE_DURATION": "240",
                    "DK_PROFILE_SCHEDULE": "0 * * * *"
                }
            },
            {
                "name": "legacy-python-profiler",
                "language": "python",
                "namespace_selectors": [
                    "^production$"
                ],
                "label_selectors": [
                    "profiling=py-spy"
                ],
                "check_annotation": false,
                "image": "pubrepo.guance.com/datakit-operator/py-spy:0.1.0",
                "envs": {
                    "DK_AGENT_HOST": "datakit-service.datakit.svc.cluster.local",
                    "DK_AGENT_PORT": "9529",
                    "DK_PROFILE_DURATION": "240",
                    "DK_PROFILE_SCHEDULE": "0 * * * *"
                }
            }
        ]
    }
}

check_annotation: true の場合は、言語に応じて Pod に admission.datakit/java-profiler.version または admission.datakit/python-profiler.version を指定します。この値はイメージのタグを上書きします。Pod 単位で旧方式の Profiler を無効にするには、admission.datakit/profiler.enabled: "false" を設定します。

ルールに一致すると、Operator は datakit-profiler Sidecar、共有プロセス名前空間、作業ディレクトリ、/tmp および /etc/localtime のマウントを追加し、Pod の restartPolicy を Always に設定します。本番導入前に、これらの変更が Pod のセキュリティポリシーに適合することを確認してください。

Java (async-profiler)

ノードで perf_events が許可されていること。通常は kernel.perf_event_paranoid が 2 以下である必要があります。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: movies-java
  namespace: production
spec:
  replicas: 1
  selector:
    matchLabels:
      app: movies-java
  template:
    metadata:
      labels:
        app: movies-java
        profiling: async-profiler
    spec:
      containers:
        - name: app
          image: example/movies-java:1.2.3
          securityContext:
            seccompProfile:
              type: Unconfined

作成後、kubectl get pod -n production -l app=movies-java -o yaml を実行し、datakit-profiler が存在することを確認します。データがない場合は、Sidecar のログ、カーネルパラメーター、capability、および DataKit の Profile 受信アドレスを確認してください。

Python (py-spy)

py-spy が対応するのは CPython のみです。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: movies-python
  namespace: production
spec:
  replicas: 1
  selector:
    matchLabels:
      app: movies-python
  template:
    metadata:
      labels:
        app: movies-python
        profiling: py-spy
    spec:
      containers:
        - name: app
          image: example/movies-python:1.2.3

作成後、kubectl get pod -n production -l app=movies-python -o yaml を実行し、datakit-profiler が存在することを確認します。データがない場合は、Sidecar のログ、capability、対象プロセスが CPython であること、および DataKit の Profile 受信アドレスを確認してください。

フィードバック

このページは役に立ちましたか?