[Internal] PPAF: Adds PPAF information to diagnostics

[NaluTripician]

Pull Request Template

Description

Adds PPAF flag to user agent string when feature is enabled.

See #5027

Diagnostics example with ApplicationName:

{
    "Summary": {
        "DirectCalls": {
            "(200, 0)": 1
        },
        "GatewayCalls": {
            "(200, 0)": 2
        }
    },
    "name": "ReadItemAsync",
    "start datetime": "2025-02-20T20:49:57.316Z",
    "duration in milliseconds": 131.3269,
    "data": {
        "Client Configuration": {
            "Client Created Time Utc": "2025-02-20T20:49:57.3159592Z",
            "MachineId": "hashedMachineName:94d755e6-4bd9-6d68-c9d4-22b4d44d5b96",
            "NumberOfClientsCreated": 1,
            "NumberOfActiveClients": 1,
            "ConnectionMode": "Direct",
            "User Agent": "cosmos-netstandard-sdk/3.46.1|0|X64|Microsoft Windows 10.0.26100|.NET 6.0.36|S|ppaf|appName",
            "ConnectionConfig": {
                "gw": "(cps:50, urto:6, p:False, httpf: False)",
                "rntbd": "(cto: 5, icto: -1, mrpc: 30, mcpe: 65535, erd: True, pr: ReuseUnicastPort)",
                "other": "(ed:False, be:False)"
            },
            "ConsistencyConfig": "(consistency: NotSet, prgns:[West US 3, East US], apprgn: )",
            "ProcessorCount": 12
        }
    }
}

Diagnostics example without ApplicationName:

{
    "Summary": {
        "DirectCalls": {
            "(200, 0)": 1
        },
        "GatewayCalls": {
            "(200, 0)": 2
        }
    },
    "name": "ReadItemAsync",
    "start datetime": "2025-02-20T20:49:57.316Z",
    "duration in milliseconds": 131.3269,
    "data": {
        "Client Configuration": {
            "Client Created Time Utc": "2025-02-20T20:49:57.3159592Z",
            "MachineId": "hashedMachineName:94d755e6-4bd9-6d68-c9d4-22b4d44d5b96",
            "NumberOfClientsCreated": 1,
            "NumberOfActiveClients": 1,
            "ConnectionMode": "Direct",
            "User Agent": "cosmos-netstandard-sdk/3.46.1|0|X64|Microsoft Windows 10.0.26100|.NET 6.0.36|S|ppaf",
            "ConnectionConfig": {
                "gw": "(cps:50, urto:6, p:False, httpf: False)",
                "rntbd": "(cto: 5, icto: -1, mrpc: 30, mcpe: 65535, erd: True, pr: ReuseUnicastPort)",
                "other": "(ed:False, be:False)"
            },
            "ConsistencyConfig": "(consistency: NotSet, prgns:[West US 3, East US], apprgn: )",
            "ProcessorCount": 12
        }
    }
}

Type of change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)

Closing issues

To automatically close an issue: closes #5027

[kundadebdatta]

Can we use interpolated string instead of concatenation ?

[kundadebdatta]

nit: Let's add [Owner("")] section as well.

[kundadebdatta]

LGTM.

[kundadebdatta]

@NaluTripician : I think it would be great if you could attach a section of the diagnostics, with the new changes in the user agent.

[kirankumarkolli]

UserAgent prefix length has limitation. How about limit it to a single character?

[FabianMeiswinkel]

I would actually prefer us agreeing on a flags enum (bit mask) - like for SDK-Capabilities. We can use the same bit mask in Java (when featuresa re applicable both) - this would make it easier to consume this in Kusto

[FabianMeiswinkel]

so something like |F7| (for Features of bit 1, 2 and 4)

[NaluTripician]

I can change to F7 to have it consistent with Java. For when PPCB is added, what would the flag be for when both ppaf and ppcb are enabled?