Skip to content

: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.

2.7 KB
Raw Blame
from posthog.models.activity_logging.activity_log import Detail, Trigger, changes_between, log_activity
from posthog.models.signals import model_activity_signal, mutable_receiver

from products.feature_flags.backend.facade.enums import SCHEDULED_CHANGE_JOB_TYPE
from products.feature_flags.backend.models.feature_flag import FeatureFlag

# Lives here, not in api/feature_flag.py, so it can wire at AppConfig.ready() without dragging that
# viewset (which pulls scipy via the dashboard -> error-tracking query runners cross-import) onto the
# django.setup() path. Flags are mutated outside web requests (cohort recalculation, scheduled
# changes), so the audit log must connect in every process.


@mutable_receiver(model_activity_signal, sender=FeatureFlag)
def handle_feature_flag_change(
    sender,
    scope,
    before_update,
    after_update,
    activity,
    was_impersonated=False,
    **kwargs,
):
    # Extract scheduled change context if present
    scheduled_change_context = getattr(after_update, "_scheduled_change_context", {})
    scheduled_change_id = scheduled_change_context.get("scheduled_change_id")
    is_scheduled_change = scheduled_change_id is not None

    # A caller that rewrites the flag as a side effect of another action (for example the
    # experiment exposure freeze) sets _activity_trigger on the instance before the gated
    # write, so the log entry can say what drove the rewrite instead of reading as a
    # manual edit. An explicit caller trigger wins over the derived scheduled-change one.
    trigger = getattr(after_update, "_activity_trigger", None)
    if is_scheduled_change and trigger is None:
        trigger = Trigger(
            job_type=SCHEDULED_CHANGE_JOB_TYPE,
            job_id=str(scheduled_change_id),
            payload={"scheduled_change_id": scheduled_change_id},
        )

    changes = changes_between(scope, previous=before_update, current=after_update)
    resolved_activity = activity
    deleted_change = next((change for change in changes if change.field == "deleted"), None)
    if deleted_change:
        if bool(deleted_change.after):
            resolved_activity = "deleted"
        elif bool(deleted_change.before):
            resolved_activity = "restored"

    log_activity(
        organization_id=after_update.team.organization_id,
        team_id=after_update.team_id,
        user=after_update.last_modified_by,
        was_impersonated=was_impersonated,
        item_id=after_update.id,
        scope=scope,
        activity=resolved_activity,
        detail=Detail(
            changes=changes,
            name=after_update.key,
            trigger=trigger,
            context=getattr(after_update, "_activity_context", None),
        ),
    )