pxtrace.UpsertTracepoint

Deploys a tracepoint on a process and collects the traced data into a table.

Deploys the tracepoint on the process (UPID) for the specified amount of time (TTL). The provided name uniquely identifies the tracepoint, and is used to manage the tracepoint (e.g. future calls to UpsertTracepoint or DeleteTracepoint.) A call to UpsertTracepoint on an existing tracepoint resets the TTL, but otherwise has no effect. A call to UpsertTracepoint on an existing tracepoint with a different tracepoint function will fail. UpsertTracepoint automatically creates a table with the provided name should it not exist; if the table exists but has a different schema, the deployment will fail.

Arguments

Name	Type	Description
name	str	The name of the tracepoint. Should be unique with the probe_fn.
table_name	str	The table name to write the results. The table is created if it does not exist. The table schema must match if the table does exist.
probe_fn	Union[px.ProbeFn, str, pxtrace.TraceProgram, List[pxtrace.TraceProgram]]	The tracepoint function, BPFTrace program or pxtrace.TraceProgram to deploy.
target	Union[px.UPID,px.SharedObject,pxtrace.PodProcess,pxtrace.LabelSelector]	The process or shared object to trace as specified by unique Vizier PID.
ttl	px.Duration	The length of time that a tracepoint will stay alive, after which it will be removed.

This site uses cookies to provide you with a better user experience. By using Pixie, you consent to our use of cookies.