-
Notifications
You must be signed in to change notification settings - Fork 33
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Populate feature flag telemetry metadata when feature flag telemetry is enabled #517
Changes from 11 commits
429ec6e
8ce6409
e068121
9f5f126
8ed359d
1a95a53
5e36fe3
74553d8
d208f2e
35e2741
07f7c7f
c166081
d916ad4
e7ba889
c068492
5815b5c
790e412
a47f147
80178fb
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -5,6 +5,8 @@ | |
using System; | ||
using System.Collections.Generic; | ||
using System.Linq; | ||
using System.Security.Cryptography; | ||
using System.Text; | ||
using System.Text.Json; | ||
using System.Threading; | ||
using System.Threading.Tasks; | ||
|
@@ -20,7 +22,7 @@ public FeatureManagementKeyValueAdapter(FeatureFilterTracing featureFilterTracin | |
_featureFilterTracing = featureFilterTracing ?? throw new ArgumentNullException(nameof(featureFilterTracing)); | ||
} | ||
|
||
public Task<IEnumerable<KeyValuePair<string, string>>> ProcessKeyValue(ConfigurationSetting setting, Logger logger, CancellationToken cancellationToken) | ||
public Task<IEnumerable<KeyValuePair<string, string>>> ProcessKeyValue(ConfigurationSetting setting, Uri endpoint, Logger logger, CancellationToken cancellationToken) | ||
{ | ||
FeatureFlag featureFlag; | ||
try | ||
|
@@ -195,18 +197,56 @@ public FeatureManagementKeyValueAdapter(FeatureFilterTracing featureFilterTracin | |
|
||
string telemetryPath = $"{featureFlagPath}:{FeatureManagementConstants.Telemetry}"; | ||
|
||
if (telemetry.Enabled) | ||
{ | ||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Enabled}", telemetry.Enabled.ToString())); | ||
} | ||
|
||
if (telemetry.Metadata != null) | ||
{ | ||
foreach (KeyValuePair<string, string> kvp in telemetry.Metadata) | ||
{ | ||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Metadata}:{kvp.Key}", kvp.Value)); | ||
} | ||
} | ||
|
||
if (telemetry.Enabled) | ||
{ | ||
byte[] featureFlagIdHash; | ||
|
||
using (HashAlgorithm hashAlgorithm = SHA256.Create()) | ||
{ | ||
featureFlagIdHash = hashAlgorithm.ComputeHash(Encoding.UTF8.GetBytes($"{setting.Key}\n{(string.IsNullOrWhiteSpace(setting.Label) ? null : setting.Label)}")); | ||
} | ||
|
||
string featureFlagIdBase64 = Convert.ToBase64String(featureFlagIdHash); | ||
|
||
StringBuilder featureFlagIdBuilder = new StringBuilder(featureFlagIdBase64[featureFlagIdBase64.Length - 1] == '=' ? featureFlagIdBase64.Length - 1 : featureFlagIdBase64.Length); | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can't b64 have two equal signs at the end? also, seems like you should be using There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Good catch. There's an appendix about implementing it we could follow https://datatracker.ietf.org/doc/html/rfc7515#appendix-C, they split to remove all "=", but index would work too (and probably better) |
||
|
||
for (int i = 0; i < featureFlagIdBuilder.Capacity; i++) | ||
amerjusupovic marked this conversation as resolved.
Show resolved
Hide resolved
|
||
{ | ||
if (featureFlagIdBase64[i] == '+') | ||
{ | ||
featureFlagIdBuilder.Append('-'); | ||
} | ||
else if (featureFlagIdBase64[i] == '/') | ||
{ | ||
featureFlagIdBuilder.Append('_'); | ||
} | ||
else | ||
{ | ||
featureFlagIdBuilder.Append(featureFlagIdBase64[i]); | ||
} | ||
} | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can we add some comments to explain how the featureFlagId is supposed to be calculated? It's not clear why we are doing some of the operations we are doing here. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think it would also add clarity if we move the b64url into an extension method. ToBase64UrlString(this bytes[]); At that point the code will be more self explanatory. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Right, won't mind if we move the whole featureFlagId calculation to a separate method. This function is getting way too long. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think I'll go with the extension for now since it makes sense to me conceptually, but let me know if you have any other concerns There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Will the extension method be reusable somewhere? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I just want to point out that the featureFlagId calculation is "by convention". It's not persisted anywhere. Portal and all our other providers will do the same calculation on-fly. Since the .NET provider is the first one doing this, it will make everyone's life easier if we can encapsulate it in one function with detailed comments so others can review/reference. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @amerjusupovic Can we please go with b64url extension method and private static method for There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. sounds good to me There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @zhenlan do you think the extension method is unnecessary? I thought it made sense to be an extension just because it's a known conversion, but it's true that we're only using it here. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I would recommend keeping that extension method. b64url is a spec and encapsulates well as utility method. Similar to frameworks |
||
|
||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Metadata}:{FeatureManagementConstants.FeatureFlagId}", featureFlagIdBuilder.ToString())); | ||
|
||
if (endpoint != null) | ||
{ | ||
string featureFlagReference = $"{endpoint.AbsoluteUri}kv/{setting.Key}{(setting.Label != null ? $"?label={setting.Label}" : "")}"; | ||
amerjusupovic marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Metadata}:{FeatureManagementConstants.FeatureFlagReference}", featureFlagReference)); | ||
} | ||
|
||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Metadata}:{FeatureManagementConstants.ETag}", setting.ETag.ToString())); | ||
|
||
keyValues.Add(new KeyValuePair<string, string>($"{telemetryPath}:{FeatureManagementConstants.Enabled}", telemetry.Enabled.ToString())); | ||
} | ||
} | ||
|
||
return Task.FromResult<IEnumerable<KeyValuePair<string, string>>>(keyValues); | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we move this inside the
if (telemetry.Enabled)
? No one cares about it if telemetry is not enabled.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I see now, I thought there was a scenario in feature management where it could still be used but I don't see how. I can move it inside the enabled block too.