No results for ""
EXPAND ALL
  • Home
  • API docs

GIVE DOCS FEEDBACK

Change history

Read time: 6 minutes
Last edited: May 28, 2024
The change history is replacing the audit log

For information on the audit log, read Audit log and resource history.

Overview

This topic explains how to track changes made in LaunchDarkly. LaunchDarkly keeps a running log of changes made to feature flags and other resources in each environment.

View the change history

The unlimited change history is a Pro and Enterprise feature

The unlimited change history is available to customers on a Pro or Enterprise plan. For Starter plans, the change history is restricted to the last 30 days of events. To learn more, read about our pricing. To upgrade your plan, contact Sales.

The change history is a running tally of changes made to feature flags or other resources in a given environment.

To access the change history, click the clock icon from any page:

A portion of the flags list, with the "clock" icon highlighted.
A portion of the flags list, with the "clock" icon highlighted.

The "Change history" dialog appears. It is automatically filtered based on the page from which you clicked the clock icon. For example, if you click the clock icon from the flags list, the change history is filtered to show changes for flags in your current project, in the environments that you have selected on the flags list:

The "Change history" dialog, automatically filtered by resource, project, and environment.
The "Change history" dialog, automatically filtered by resource, project, and environment.

Filter the change history

To filter the change history, use the "Filter by resource" section.

You can use the "Filter by resource" section to filter the results by any of the following resources:

  • Account
  • Application
  • Code reference
  • Context kind
  • Experiment
  • Flag
  • Integration
  • Member
  • Metric
  • Project
  • Relay Proxy
  • Release pipeline
  • Role
  • Segment
  • Service token
  • Team
  • Webhook

You can also filter for changes in particular projects, environments, and actions.

Click the link button in the "Filter by resource" section to copy a link to the current change history filter. You can share this with other members in your organization.

Actions recorded in the change history

In the LaunchDarkly UI, the change history displays a description of each action or set of actions, as entered by the member who performed them. If you use the REST API to review the change history, the API response also includes a list of the specific actions.

The following sections describe the actions that the change history records.

Expand for actions related to targeting changes

The following table includes the actions related to targeting changes that are recorded in the change history. Unless otherwise specified, these actions affect only the current environment:

Action on flagName in REST responseDescription
Update fallthroughupdateFallthroughUpdate the default rule, also called the "fallthrough" rule.
Update flag variationsupdateFlagVariationsChange the flag's variations. This action affects all environments in a project.
Update release workflowsupdateFeatureWorkflowsChange a flag's release management workflows.
Update global archivedupdateGlobalArchivedChange whether a flag is archived. This action affects all environments in a project.
Update off variationupdateOffVariationUpdate the variation returned when the flag is toggled off.
Update onupdateOnToggle a flag's targeting on or off.
Update prerequisitesupdatePrerequisitesUpdate flag prerequisites.
Update rulesupdateRulesUpdate custom targeting rules.
Update scheduled changesupdateScheduledChangesChange the scheduled updates on a feature flag.
Update targetsupdateTargetsUpdate individual context targeting rules.
Expand for actions related to flag settings

The following table includes the actions related to flag settings that are recorded in the change history. Each of these actions affect all environments in a project:

Action on flagName in REST responseDescription
Create flagcreateFlagCreate a flag.
Delete flagdeleteFlagDelete a flag.
Update client-side flag availabilityupdateClientSideFlagAvailabilityChange whether the flag is available to client-side SDKs.
Update descriptionupdateDescriptionChange the description of a flag.
Update flag custom propertiesupdateFlagCustomPropertiesUpdate custom properties attached to a flag.
Update flag default variationsupdateFlagDefaultVariationsChange the default flag variations used by newly-created environments for a flag.
Update include in snippetupdateIncludeInSnippetChange whether the feature flag is available to front-end code with the JavaScript SDK.
Update nameupdateNameRename a flag.
Update tagsupdateTagsUpdate tags associated with a flag.
Update temporaryupdateTemporaryMark a flag temporary or permanent.
Expand for actions related to environment-specific settings

The following table includes the actions related to environment-specific settings that are recorded in the change history:

Action on flagName in REST responseDescription
Create triggerscreateTriggersCreate a new trigger.
Delete triggersdeleteTriggersDelete a trigger.
Update flag saltupdateFlagSaltUpdate a flag's salt.
Update track eventsupdateTrackEventsChange whether to send detailed event information for a flag in a given environment.
Update triggersupdateTriggersUpdate an existing trigger.
Expand for actions related to collaboration

The following table includes the actions related to collaboration that are recorded in the change history:

Action on flagName in REST responseDescription
Apply approval requestapplyApprovalRequestApply an approved approval request for a flag.
Bypass required approvalbypassRequiredApprovalBypass required approvals in the environment.
Create approval requestcreateApprovalRequestCreate an approval request for a flag.
Create flag linkcreateFlagLinkCreate a flag link. This affects all environments in a project.
Delete approval requestdeleteApprovalRequestDelete an approval request for a flag.
Delete flag linkdeleteFlagLinkDelete a flag link. This affects all environments in a project.
Manage flag followersmanageFlagFollowersManage the list of members who receive flag change notifications.
Review approval requestreviewApprovalRequestApprove or decline an approval request for a flag.
Update maintainerupdateMaintainerUpdate the flag maintainer. This affects all environments in a project.
Update flag linkupdateFlagLinkUpdate a flag link. This affects all environments in a project.
Expand for actions related to other flag changes

The following table includes the actions related to other flag changes that are recorded in the change history:

Action on flagName in REST responseDescription
Clone flagcloneFlagCreate a new flag with settings based on an existing flag. This affects all environments in a project.
Copy flag config fromcopyFlagConfigFromCopy settings from a flag.
Copy flag config tocopyFlagConfigToCopy settings to a flag.
Update expiring targetsupdateExpiringTargetsChange a flag's expiring individual context targeting rules.
Update flag rule descriptionupdateFlagRuleDescriptionUpdate the description for custom targeting rules.