旧方式の Profiler 注入¶
Profiler 注入は旧バージョンとの互換性を保つための機能です
新規導入には Flameshot を使用してください。Flameshot ではプロセスごとに計測時間を設定でき、スケジュールに従って、または CPU やメモリの使用量がしきい値に達したときに計測を開始できます。
旧方式の datakit-profiler Sidecar は、Java アプリケーションを async-profiler で、Python アプリケーションを py-spy でサンプリングします。
前提条件¶
- DataKit で Profile コレクターが有効になっていること。
- Pod のセキュリティポリシーで、Sidecar への
SYS_PTRACEおよびSYS_ADMINcapability の追加が許可されていること。
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 受信アドレスを確認してください。