launchdarkly / LaunchDarkly-Docs

MIT License
28 stars 129 forks source link

Custom Attributes - Documentation lacks clarity around persistence #329

Closed ckartik closed 1 year ago

ckartik commented 1 year ago

There is a lack of clarity around attribute persistence in Launch Darkly servers for 5.x SDK and the broader LD API.

In particular if we use the Identify endpoint as follows:

user := userBuilder.Custom("Attribute-1", "value").Build
client.Identify(user)

There's no clear expectation of the attribute being persisted in the LD API as per the documents. The ask is to update the Documentation to provide one of the following clarifications around support for persisted custom attributes:

mmrj commented 1 year ago

Hi @ckartik , thanks for reaching out. Which SDK (language and version) are you using?

mmrj commented 1 year ago

The LaunchDarkly SDKs are specialized for the tasks of evaluating feature flags in your application and generating analytics events based on those evaluations.

When your application starts up, your code should initialize the LaunchDarkly SDK you're working with. When a customer encounters a feature flag in your application, your code should use the SDK to evaluate the feature flag and retrieve the appropriate flag variation for that customer.

The LaunchDarkly UI displays the user objects that your application has identified or evaluated flags for, on the Users list, including any attributes that you have added to the object. As described in that topic, under User storage, users appear on the list for 30 days.

The LaunchDarkly API is separate from the LaunchDarkly SDKs. It allows you to perform all of the functions available in the LaunchDarkly UI through a REST API. To learn more, you can read Comparing LaunchDarkly’s SDKs and REST API.