:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from uuid import NAMESPACE_URL, uuid5
from posthog.models import User
from posthog.ph_client import ph_background_capture
from products.wizard.backend.facade.contracts import (
WizardRunArtifactDTO,
WizardRunDTO,
WizardRunGitDiffArtifactDTO,
WizardRunPullRequestArtifactDTO,
)
from products.wizard.backend.facade.enums import WizardRunEnvironment, WizardRunStage
from products.wizard.backend.observability.config import (
WIZARD_RUN_ARTIFACT_CREATED_EVENT,
WIZARD_RUN_DISPATCH_FINISHED_EVENT,
WIZARD_RUN_FINISHED_EVENT,
WIZARD_RUN_STAGE_ENTERED_EVENT,
WIZARD_RUN_STARTED_EVENT,
WIZARD_WORKER_USAGE_RECORDED_EVENT,
)
from products.wizard.backend.observability.contracts import WizardRunDispatchOutcome, WizardWorkerUsageObservation
type WizardEventProperty = str | int | float | bool | None
type WizardEventProperties = dict[str, WizardEventProperty]
def enqueue_run_created(run: WizardRunDTO) -> None:
_enqueue_run_event(
run,
WIZARD_RUN_STARTED_EVENT,
"started",
{
"location": "wizard_library",
"program": run.program.name,
},
)
def enqueue_dispatch_finished(run: WizardRunDTO, outcome: WizardRunDispatchOutcome) -> None:
_enqueue_run_event(
run,
WIZARD_RUN_DISPATCH_FINISHED_EVENT,
f"dispatch:{outcome.value}",
{"outcome": outcome.value},
)
def enqueue_stage_entered(run: WizardRunDTO, stage: WizardRunStage) -> None:
_enqueue_run_event(
run,
WIZARD_RUN_STAGE_ENTERED_EVENT,
f"stage:{stage.value}",
{"stage": stage.value},
)
def enqueue_run_finished(run: WizardRunDTO, failure_stage: WizardRunStage | None) -> None:
properties: WizardEventProperties = {
"status": run.status.value,
"error_code": run.error_code,
"failure_stage": failure_stage.value if failure_stage is not None else None,
}
if run.started_at is not None and run.finished_at is not None:
properties["duration_seconds"] = max((run.finished_at - run.started_at).total_seconds(), 0)
_enqueue_run_event(run, WIZARD_RUN_FINISHED_EVENT, f"terminal:{run.status.value}", properties)
def enqueue_worker_usage(run: WizardRunDTO, usage: WizardWorkerUsageObservation) -> None:
_enqueue_run_event(
run,
WIZARD_WORKER_USAGE_RECORDED_EVENT,
"worker_usage",
{
"lifetime_seconds": usage.lifetime_seconds,
"cpu_cores": usage.cpu_cores,
"memory_gb": usage.memory_gb,
"disk_size_gb": usage.disk_size_gb,
"cpu_usage_seconds": usage.cpu_usage_seconds,
"billed_cpu_usage_seconds": usage.billed_cpu_usage_seconds,
},
)
def enqueue_artifact_created(run: WizardRunDTO, artifact: WizardRunArtifactDTO) -> None:
if isinstance(artifact, WizardRunPullRequestArtifactDTO):
properties: WizardEventProperties = {
"type": "pull_request",
"url": artifact.url,
"name": f"Pull request #{artifact.number}",
}
elif isinstance(artifact, WizardRunGitDiffArtifactDTO):
properties = {"type": "diff", "url": None, "name": "Git diff"}
_enqueue_run_event(run, WIZARD_RUN_ARTIFACT_CREATED_EVENT, f"artifact:{artifact.id}", properties)
def _enqueue_run_event(
run: WizardRunDTO,
event: str,
event_key: str,
properties: WizardEventProperties | None = None,
) -> None:
event_uuid = uuid5(NAMESPACE_URL, f"wizard:{run.id}:{event_key}")
event_properties: WizardEventProperties = {
"event_source": "wizard_run_service",
"project_id": str(run.team_id),
"environment": run.environment.value,
"run_surface": run.environment.value,
"workspace_type": run.workspace.type,
"program_id": run.program.id,
"wizard_version": run.program.wizard_version,
"version": run.program.wizard_version,
"command": run.program.command[0] if run.program.command else "default",
}
if run.environment == WizardRunEnvironment.CLOUD:
event_properties["task_run_id"] = str(run.id)
if properties is not None:
event_properties.update(properties)
distinct_id = str(run.id)
if run.created_by_id is not None:
user_distinct_id = User.objects.filter(id=run.created_by_id).values_list("distinct_id", flat=True).first()
if user_distinct_id is not None:
distinct_id = user_distinct_id
ph_background_capture()(
distinct_id=distinct_id,
event=event,
properties={**event_properties, "team_id": run.team_id, "wizard_run_id": str(run.id)},
uuid=str(event_uuid),
)