StoreBroker/Telemetry.ps1
|
# Copyright (C) Microsoft Corporation. All rights reserved. # Singleton telemetry client. Don't directly access this though....always get it # by calling Get-TelemetryClient to ensure that the singleton is properly initialized. $script:SBTelemetryClient = $null Add-Type -TypeDefinition @" public enum StoreBrokerTelemetryProperty { AddPackages, AppId, AppName, AppxVersion, AutoCommit, DayOfWeek, ErrorBucket, ExistingPackageRolloutAction, FlightId, Force, HResult, IapId, IsMandatoryUpdate, Message, PackagePath, PackageRolloutPercentage, ProductId, ProductType, ReplacePackages, ShowFlight, ShowSubmission, SourceFilePath, SubmissionId, UpdateAppProperties, UpdateListings, UpdateNotesForCertification, UpdatePricingAndAvailability, UpdateProperties, UpdatePublishMode, UpdatePublishModeAndVisibility, UriFragment, UserName, Web, } "@ Add-Type -TypeDefinition @" public enum StoreBrokerTelemetryMetric { Duration, NumEmailAddresses, } "@ function Initialize-TelemetryGlobalVariables { <# .SYNOPSIS Initializes the global variables that are "owned" by the Telemetry script file. .DESCRIPTION Initializes the global variables that are "owned" by the Telemetry script file. Global variables are used sparingly to enables users a way to control certain extensibility points with this module. The Git repo for this module can be found here: http://aka.ms/StoreBroker .NOTES Internal-only helper method. The only reason this exists is so that we can leverage CodeAnalysis.SuppressMessageAttribute, which can only be applied to functions. Otherwise, we would have just had the relevant initialization code directly above the function that references the variable. We call this immediately after the declaration so that the variables are available for reference in any function below. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="We are initializing multiple variables.")] # Note, this doesn't currently work due to https://github.com/PowerShell/PSScriptAnalyzer/issues/698 [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseDeclaredVarsMoreThanAssignment", "", Justification = "These are global variables and so are used elsewhere.")] param() # We only set their values if they don't already have values defined. # We use -ErrorAction Ignore during the Get-Variable check since it throws an exception # by default if the variable we're getting doesn't exist, and we just want the bool result. # SilentlyContinue would cause it to go into the global $Error array, Ignore prevents that as well. if (!(Get-Variable -Name SBDisableTelemetry -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBDisableTelemetry = $false } if (!(Get-Variable -Name SBDisablePiiProtection -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBDisablePiiProtection = $false } if (!(Get-Variable -Name SBApplicationInsightsKey -Scope Global -ValueOnly -ErrorAction Ignore)) { $global:SBApplicationInsightsKey = '4cdaa89f-33c5-46b4-ba5a-3befb5d8fe01' } } # We need to be sure to call this explicitly so that the global variables get initialized. Initialize-TelemetryGlobalVariables function Get-PiiSafeString { <# .SYNOPSIS If PII protection is enabled, returns back an SHA512-hashed value for the specified string, otherwise returns back the original string, untouched. .SYNOPSIS If PII protection is enabled, returns back an SHA512-hashed value for the specified string, otherwise returns back the original string, untouched. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER PlainText The plain text that contains PII that may need to be protected. .EXAMPLE Get-PiiSafeString -PlainText "Hello World" Returns back the string "B10A8DB164E0754105B7A99BE72E3FE5" which respresents the SHA512 hash of "Hello World", but only if $global:SBDisablePiiProtection is $false. If it's $true, "Hello World" will be returned. .OUTPUTS System.String - A SHA512 hash of PlainText will be returned if $global:SBDisablePiiProtection is $false, otherwise PlainText will be returned untouched. #> [CmdletBinding()] [OutputType([String])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] param( [Parameter(Mandatory)] [AllowNull()] [AllowEmptyString()] [string] $PlainText ) if ($global:SBDisablePiiProtection) { return $PlainText } else { return (Get-SHA512Hash -PlainText $PlainText) } } function Get-ApplicationInsightsDllPath { <# .SYNOPSIS Makes sure that the Microsoft.ApplicationInsights.dll assembly is available on the machine, and returns the path to it. .DESCRIPTION Makes sure that the Microsoft.ApplicationInsights.dll assembly is available on the machine, and returns the path to it. This will first look for the assembly in the module's script directory. Next it will look for the assembly in the location defined by $SBAlternateAssemblyDir. This value would have to be defined by the user prior to execution of this cmdlet. If not found there, it will look in a temp folder established during this PowerShell session. If still not found, it will download the nuget package for it to a temp folder accessible during this PowerShell session. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Get-ApplicationInsightsDllPath Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will show a time duration status counter while the package is being downloaded. .EXAMPLE Get-ApplicationInsightsDllPath -NoStatus Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will appear to hang during this time. .OUTPUTS System.String - The path to the Microsoft.ApplicationInsights.dll assembly. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [switch] $NoStatus ) $nugetPackageName = "Microsoft.ApplicationInsights" $nugetPackageVersion = "2.0.1" $assemblyPackageTailDir = "Microsoft.ApplicationInsights.2.0.1\lib\net45" $assemblyName = "Microsoft.ApplicationInsights.dll" return Get-NugetPackageDllPath -NugetPackageName $nugetPackageName -NugetPackageVersion $nugetPackageVersion -AssemblyPackageTailDirectory $assemblyPackageTailDir -AssemblyName $assemblyName -NoStatus:$NoStatus } function Get-DiagnosticsTracingDllPath { <# .SYNOPSIS Makes sure that the Microsoft.Diagnostics.Tracing.EventSource.dll assembly is available on the machine, and returns the path to it. .DESCRIPTION Makes sure that the Microsoft.Diagnostics.Tracing.EventSource.dll assembly is available on the machine, and returns the path to it. This will first look for the assembly in the module's script directory. Next it will look for the assembly in the location defined by $SBAlternateAssemblyDir. This value would have to be defined by the user prior to execution of this cmdlet. If not found there, it will look in a temp folder established during this PowerShell session. If still not found, it will download the nuget package for it to a temp folder accessible during this PowerShell session. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Get-DiagnosticsTracingDllPath Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will show a time duration status counter while the package is being downloaded. .EXAMPLE Get-DiagnosticsTracingDllPath -NoStatus Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will appear to hang during this time. .OUTPUTS System.String - The path to the Microsoft.ApplicationInsights.dll assembly. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [switch] $NoStatus ) $nugetPackageName = "Microsoft.Diagnostics.Tracing.EventSource.Redist" $nugetPackageVersion = "1.1.24" $assemblyPackageTailDir = "Microsoft.Diagnostics.Tracing.EventSource.Redist.1.1.24\lib\net35" $assemblyName = "Microsoft.Diagnostics.Tracing.EventSource.dll" return Get-NugetPackageDllPath -NugetPackageName $nugetPackageName -NugetPackageVersion $nugetPackageVersion -AssemblyPackageTailDirectory $assemblyPackageTailDir -AssemblyName $assemblyName -NoStatus:$NoStatus } function Get-ThreadingTasksDllPath { <# .SYNOPSIS Makes sure that the Microsoft.Threading.Tasks.dll assembly is available on the machine, and returns the path to it. .DESCRIPTION Makes sure that the Microsoft.Threading.Tasks.dll assembly is available on the machine, and returns the path to it. This will first look for the assembly in the module's script directory. Next it will look for the assembly in the location defined by $SBAlternateAssemblyDir. This value would have to be defined by the user prior to execution of this cmdlet. If not found there, it will look in a temp folder established during this PowerShell session. If still not found, it will download the nuget package for it to a temp folder accessible during this PowerShell session. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Get-ThreadingTasksDllPath Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will show a time duration status counter while the package is being downloaded. .EXAMPLE Get-ThreadingTasksDllPath -NoStatus Returns back the path to the assembly as found. If the package has to be downloaded via nuget, the command prompt will appear to hang during this time. .OUTPUTS System.String - The path to the Microsoft.ApplicationInsights.dll assembly. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [switch] $NoStatus ) $nugetPackageName = "Microsoft.Bcl.Async" $nugetPackageVersion = "1.0.168.0" $assemblyPackageTailDir = "Microsoft.Bcl.Async.1.0.168\lib\net40" $assemblyName = "Microsoft.Threading.Tasks.dll" return Get-NugetPackageDllPath -NugetPackageName $nugetPackageName -NugetPackageVersion $nugetPackageVersion -AssemblyPackageTailDirectory $assemblyPackageTailDir -AssemblyName $assemblyName -NoStatus:$NoStatus } function Get-TelemetryClient { <# .SYNOPSIS Returns back the singleton instance of the Application Insights TelemetryClient for this module. .DESCRIPTION Returns back the singleton instance of the Application Insights TelemetryClient for this module. If the singleton hasn't been initialized yet, this will ensure all dependenty assemblies are available on the machine, create the client and initialize its properties. This will first look for the dependent assemblies in the module's script directory. Next it will look for the assemblies in the location defined by $SBAlternateAssemblyDir. This value would have to be defined by the user prior to execution of this cmdlet. If not found there, it will look in a temp folder established during this PowerShell session. If still not found, it will download the nuget package for it to a temp folder accessible during this PowerShell session. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Get-TelemetryClient Returns back the singleton instance to the TelemetryClient for the module. If any nuget packages have to be downloaded in order to load the TelemetryClient, the command prompt will show a time duration status counter during the download process. .EXAMPLE Get-TelemetryClient -NoStatus Returns back the singleton instance to the TelemetryClient for the module. If any nuget packages have to be downloaded in order to load the TelemetryClient, the command prompt will appear to hang during this time. .OUTPUTS Microsoft.ApplicationInsights.TelemetryClient #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [switch] $NoStatus ) if ($null -eq $script:SBTelemetryClient) { Write-Log "Telemetry is currently enabled. It can be disabled by setting ""`$global:SBDisableTelemetry = `$true"". Refer to USAGE.md#telemetry for more information." Write-Log "Initializing telemetry client." -Level Verbose $dlls = @( (Get-ThreadingTasksDllPath -NoStatus:$NoStatus), (Get-DiagnosticsTracingDllPath -NoStatus:$NoStatus), (Get-ApplicationInsightsDllPath -NoStatus:$NoStatus) ) foreach ($dll in $dlls) { $bytes = [System.IO.File]::ReadAllBytes($dll) [System.Reflection.Assembly]::Load($bytes) | Out-Null } $username = Get-PiiSafeString -PlainText $env:USERNAME $script:SBTelemetryClient = New-Object Microsoft.ApplicationInsights.TelemetryClient $script:SBTelemetryClient.InstrumentationKey = $global:SBApplicationInsightsKey $script:SBTelemetryClient.Context.User.Id = $username $script:SBTelemetryClient.Context.Session.Id = [System.GUID]::NewGuid().ToString() $script:SBTelemetryClient.Context.Properties[[StoreBrokerTelemetryProperty]::Username] = $username $script:SBTelemetryClient.Context.Properties[[StoreBrokerTelemetryProperty]::DayOfWeek] = (Get-Date).DayOfWeek $script:SBTelemetryClient.Context.Component.Version = $MyInvocation.MyCommand.Module.Version.ToString() } return $script:SBTelemetryClient } function Set-TelemetryEvent { <# .SYNOPSIS Posts a new telemetry event for this module to the configured Applications Insights instance. .DESCRIPTION Posts a new telemetry event for this module to the configured Applications Insights instance. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER EventName The name of the event that has occurred. .PARAMETER Properties A collection of name/value pairs (string/string) that should be associated with this event. .PARAMETER Metrics A collection of name/value pair metrics (string/double) that should be associated with this event. .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Set-TelemetryEvent "zFooTest1" Posts a "zFooTest1" event with the default set of properties and metrics. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the download status will be presented at the command prompt. .EXAMPLE Set-TelemetryEvent "zFooTest1" @{"Prop1" = "Value1"} Posts a "zFooTest1" event with the default set of properties and metrics along with an additional property named "Prop1" with a value of "Value1". If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the download status will be presented at the command prompt. .EXAMPLE Set-TelemetryEvent "zFooTest1" -NoStatus Posts a "zFooTest1" event with the default set of properties and metrics. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the command prompt will appear to hang while they are downloaded. .NOTES Because of the short-running nature of this module, we always "flush" the events as soon as they have been posted to ensure that they make it to Application Insights. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [Parameter(Mandatory)] [string] $EventName, [hashtable] $Properties = @{}, [hashtable] $Metrics = @{}, [switch] $NoStatus ) if ($global:SBDisableTelemetry) { Write-Log "Telemetry has been disabled via `$global:SBDisableTelemetry. Skipping reporting event." -Level Verbose return } Write-Log "Executing: $($MyInvocation.Line)" -Level Verbose try { $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus $propertiesDictionary = New-Object 'System.Collections.Generic.Dictionary[string, string]' $propertiesDictionary[[StoreBrokerTelemetryProperty]::DayOfWeek] = (Get-Date).DayOfWeek $Properties.Keys | ForEach-Object { $propertiesDictionary[$_] = $Properties[$_] } $metricsDictionary = New-Object 'System.Collections.Generic.Dictionary[string, double]' $Metrics.Keys | ForEach-Object { $metricsDictionary[$_] = $Metrics[$_] } $telemetryClient.TrackEvent($EventName, $propertiesDictionary, $metricsDictionary); # Flushing should increase the chance of success in uploading telemetry logs Flush-TelemetryClient -NoStatus:$NoStatus } catch { # Telemetry should be best-effort. Failures while trying to handle telemetry should not # cause exceptions in the app itself. Write-Log "Set-TelemetryEvent failed: $($_.Exception.Message)" -Level Error } } function Set-TelemetryException { <# .SYNOPSIS Posts a new telemetry event to the configured Application Insights instance indicating that an exception occurred in this this module. .DESCRIPTION Posts a new telemetry event to the configured Application Insights instance indicating that an exception occurred in this this module. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER Exception The exception that just occurred. .PARAMETER ErrorBucket A property to be added to the Exception being logged to make it easier to filter to exceptions resulting from similar scenarios. .PARAMETER Properties Additional properties that the caller may wish to be associated with this exception. .PARAMETER NoFlush It's not recommended to use this unless the exception is coming from Flush-TelemetryClient. By default, every time a new exception is logged, the telemetry client will be flushed to ensure that the event is published to the Application Insights. Use of this switch prevents that automatic flushing (helpful in the scenario where the exception occurred when trying to do the actual Flush). .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Set-TelemetryException $_ Used within the context of a catch statement, this will post the exception that just occurred, along with a default set of properties. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the download status will be presented at the command prompt. .EXAMPLE Set-TelemetryException $_ -NoStatus Used within the context of a catch statement, this will post the exception that just occurred, along with a default set of properties. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the command prompt will appear to hang while they are downloaded. .NOTES Because of the short-running nature of this module, we always "flush" the events as soon as they have been posted to ensure that they make it to Application Insights. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [Parameter(Mandatory)] [System.Exception] $Exception, [string] $ErrorBucket, [hashtable] $Properties = @{}, [switch] $NoFlush, [switch] $NoStatus ) if ($global:SBDisableTelemetry) { Write-Log "Telemetry has been disabled via `$global:SBDisableTelemetry. Skipping reporting event." -Level Verbose return } Write-Log "Executing: $($MyInvocation.Line)" -Level Verbose try { $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus $propertiesDictionary = New-Object 'System.Collections.Generic.Dictionary[string,string]' $propertiesDictionary[[StoreBrokerTelemetryProperty]::Message] = $Exception.Message $propertiesDictionary[[StoreBrokerTelemetryProperty]::HResult] = "0x{0}" -f [Convert]::ToString($Exception.HResult, 16) $Properties.Keys | ForEach-Object { $propertiesDictionary[$_] = $Properties[$_] } if (-not [String]::IsNullOrWhiteSpace($ErrorBucket)) { $propertiesDictionary[[StoreBrokerTelemetryProperty]::ErrorBucket] = $ErrorBucket } $telemetryClient.TrackException($Exception, $propertiesDictionary); # Flushing should increase the chance of success in uploading telemetry logs if (-not $NoFlush) { Flush-TelemetryClient -NoStatus:$NoStatus } } catch { # Telemetry should be best-effort. Failures while trying to handle telemetry should not # cause exceptions in the app itself. Write-Log "Set-TelemetryException failed: $($_.Exception.Message)" -Level Error } } function Flush-TelemetryClient { <# .SYNOPSIS Flushes the buffer of stored telemetry events to the configured Applications Insights instance. .DESCRIPTION Flushes the buffer of stored telemetry events to the configured Applications Insights instance. The Git repo for this module can be found here: http://aka.ms/StoreBroker .PARAMETER NoStatus If this switch is specified, long-running commands will run on the main thread with no commandline status update. When not specified, those commands run in the background, enabling the command prompt to provide status information. .EXAMPLE Flush-TelemetryClient Attempts to push all buffered telemetry events for this telemetry client immediately to Application Insights. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the download status will be presented at the command prompt. .EXAMPLE Flush-TelemetryClient -NoStatus Attempts to push all buffered telemetry events for this telemetry client immediately to Application Insights. If the telemetry client needs to be created to accomplish this, and the required assemblies are not available on the local machine, the command prompt will appear to hang while they are downloaded. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Justification="We use global variables sparingly and intentionally for module configuration, and employ a consistent naming convention.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseApprovedVerbs", "", Justification="Internal-only helper method. Matches the internal method that is called.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] param( [switch] $NoStatus ) if ($global:SBDisableTelemetry) { Write-Log "Telemetry has been disabled via `$global:SBDisableTelemetry. Skipping reporting event." -Level Verbose return } Write-Log "Executing: $($MyInvocation.Line)" -Level Verbose $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus try { $telemetryClient.Flush() } catch [System.Net.WebException] { Write-Log "Encountered exception while trying to flush telemetry events. [$($_.Exception.Message)]" -Level Warning Set-TelemetryException -Exception ($_.Exception) -ErrorBucket "TelemetryFlush" -NoFlush -NoStatus:$NoStatus } catch { # Any other scenario is one that we want to identify and fix so that we don't miss telemetry $output = @() $output += "Encountered a problem while trying to record telemetry events." $output += $_.Exception.Message $output += "This is non-fatal, but it would be helpful if you could report this problem" $output += "to the StoreBroker team for further investigation." Write-Log $($output -join [Environment]::NewLine) -Level Warning } } # SIG # Begin signature block # MIIdrwYJKoZIhvcNAQcCoIIdoDCCHZwCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUV1BRhZ9R+ipR6c6MWyrGzwhU # BFWgghhTMIIEwjCCA6qgAwIBAgITMwAAALwLLhp7irHHkQAAAAAAvDANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTYwOTA3MTc1ODQ3 # WhcNMTgwOTA3MTc1ODQ3WjCBsjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjEMMAoGA1UECxMDQU9DMScwJQYDVQQLEx5uQ2lwaGVyIERTRSBFU046 # MTJCNC0yRDVGLTg3RDQxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNl # cnZpY2UwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCrW5IBRZQaAQPT # HTCSXDRgGi/lbqVTqt3Mp5XqqbEkIZowQp8M/Gyv+1TmRpbFaQIQ4oQ7AqZRsvd+ # PMGtZjo6vUBRyeLKpnHq1a9XYeiGkoGaJu/98Ued3Z+sFD45bhzi6tLzY6kq98KI # YqK7XsI76kqVU3oIyiETzzoANwuXUNSnm9lAN3l/G8xgDm/3qBWMSjkBvg2GeZ57 # 3WqYP6fImkO9U0bRtuIr6mybzvXUUO+rg6hhdrEnLGI4QQ7frEWReYeyMlgjC7VR # aJy2gomkh+sEmxxivphgOuJrtPgUhdIlyTkUTtyudNUd/6gTE4zt9TsmFf5wGCsx # pbZqKFW3AgMBAAGjggEJMIIBBTAdBgNVHQ4EFgQUyHJk5pJfz0FWFyn1nlRJFHyq # /vcwHwYDVR0jBBgwFoAUIzT42VJGcArtQPt2+7MrsMM1sw8wVAYDVR0fBE0wSzBJ # oEegRYZDaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv # TWljcm9zb2Z0VGltZVN0YW1wUENBLmNybDBYBggrBgEFBQcBAQRMMEowSAYIKwYB # BQUHMAKGPGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljcm9z # b2Z0VGltZVN0YW1wUENBLmNydDATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG # 9w0BAQUFAAOCAQEAPiS9UtetZjCdEkaanFlC+NU/Ti+PUD6O+P6yCASPI6+qK20t # B16FXJg7rXRee3c/E2wcyWuxeL/0oLkj4LunxQoDDhoOjM9w9SnrWjki/kbkEdbg # i1Pl4ebDSu+6Six3fdRrLowgkQwXxkCoUWwyFS9dL5BbC5lSzHlOiXiWVlc94vr3 # 9sMaoqsxl6A6Ud9YvbohYuiKJsdpSrLW97wXO66h+Cx289JckOmomW1Zum3ppfgp # +5lJJBxySomU08S8G5QOOrvjO4KsQ55eHHVWJXhnGL+zhghaSf5TIQuDdohDOnNb # +FImqnwn3++hmpbkAVWdFUNDNlJemia/hMH9vzCCBgAwggPooAMCAQICEzMAAADD # Dpun2LLc9ywAAAAAAMMwDQYJKoZIhvcNAQELBQAwfjELMAkGA1UEBhMCVVMxEzAR # BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p # Y3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2ln # bmluZyBQQ0EgMjAxMTAeFw0xNzA4MTEyMDIwMjRaFw0xODA4MTEyMDIwMjRaMHQx # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xHjAcBgNVBAMTFU1p # Y3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC # ggEBALtX1zjRsQZ/SS2pbbNjn3q6tjohW7SYro3UpIGgxXXFLO+CQCq3gVN382MB # CrzON4QDQENXgkvO7R+2/YBtycKRXQXH3FZZAOEM61fe/fG4kCe/dUr8dbJyWLbF # SJszYgXRlZSlvzkirY0STUZi2jIZzqoiXFZIsW9FyWd2Yl0wiKMvKMUfUCrZhtsa # ESWBwvT1Zy7neR314hx19E7Mx/znvwuARyn/z81psQwLYOtn5oQbm039bUc6x9nB # YWHylRKhDQeuYyHY9Jkc/3hVge6leegggl8K2rVTGVQBVw2HkY3CfPFUhoDhYtuC # cz4mXvBAEtI51SYDDYWIMV8KC4sCAwEAAaOCAX8wggF7MB8GA1UdJQQYMBYGCisG # AQQBgjdMCAEGCCsGAQUFBwMDMB0GA1UdDgQWBBSnE10fIYlV6APunhc26vJUiDUZ # rzBRBgNVHREESjBIpEYwRDEMMAoGA1UECxMDQU9DMTQwMgYDVQQFEysyMzAwMTIr # YzgwNGI1ZWEtNDliNC00MjM4LTgzNjItZDg1MWZhMjI1NGZjMB8GA1UdIwQYMBaA # FEhuZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFf # MjAxMS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEA # TZdPNH7xcJOc49UaS5wRfmsmxKUk9N9E1CS6s2oIiZmayzHncJv/FB2wBzl/5DA7 # EyLeDsiVZ7tufvh8laSQgjeTpoPTSQLBrK1Z75G3p2YADqJMJdTc510HAsooNGU7 # OYOtlSqOyqDoCDoc/j57QEmUTY5UJQrlsccK7nE3xpteNvWnQkT7vIewDcA12SaH # X/9n7yh094owBBGKZ8xLNWBqIefDjQeDXpurnXEfKSYJEdT1gtPSNgcpruiSbZB/ # AMmoW+7QBGX7oQ5XU8zymInznxWTyAbEY1JhAk9XSBz1+3USyrX59MJpX7uhnQ1p # gyfrgz4dazHD7g7xxIRDh+4xnAYAMny3IIq5CCPqVrAY1LK9Few37WTTaxUCI8aK # M4c60Zu2wJZZLKABU4QBX/J7wXqw7NTYUvZfdYFEWRY4J1O7UPNecd/311HcMdUa # YzUql36fZjdfz1Uz77LKvCwjqkQe7vtnSLToQsMPilFYokYCYSZaGb9clOmoQHDn # WzBMfIDUUGeipe4O6z218eV5HuH1WBlvu4lteOIgWCX/5Eiz5q/xskAEF0ZQ1Axs # kRR97sri9ibeGzsEZ1EuD6QX90L/P5GJMfinvLPlOlLcKjN/SmSRZdhlEbbbare0 # bFL8v4txFsQsznOaoOldCMFFRaUphuwBMW1edMZWMQswggYHMIID76ADAgECAgph # Fmg0AAAAAAAcMA0GCSqGSIb3DQEBBQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20x # GTAXBgoJkiaJk/IsZAEZFgltaWNyb3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBS # b290IENlcnRpZmljYXRlIEF1dGhvcml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0 # MDMxMzAzMDlaMHcxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # ITAfBgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcN # AQEBBQADggEPADCCAQoCggEBAJ+hbLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP # 7tGn0UytdDAgEesH1VSVFUmUG0KSrphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySH # nfL0Zxws/HvniB3q506jocEjU8qN+kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUo # Ri4nrIZPVVIM5AMs+2qQkDBuh/NZMJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABK # R2YRJylmqJfk0waBSqL5hKcRRxQJgp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSf # rx54QTF3zJvfO4OToWECtR0Nsfz3m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGn # MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMP # MAsGA1UdDwQEAwIBhjAQBgkrBgEEAYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQO # rIJgQFYnl+UlE/wq4QpTlVnkpKFjpGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZ # MBcGCgmSJomT8ixkARkWCW1pY3Jvc29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJv # b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1Ud # HwRJMEcwRaBDoEGGP2h0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3By # b2R1Y3RzL21pY3Jvc29mdHJvb3RjZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYI # KwYBBQUHMAKGOGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWlj # cm9zb2Z0Um9vdENlcnQuY3J0MBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3 # DQEBBQUAA4ICAQAQl4rDXANENt3ptK132855UU0BsS50cVttDBOrzr57j7gu1BKi # jG1iuFcCy04gE1CZ3XpA4le7r1iaHOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV # 3U+rkuTnjWrVgMHmlPIGL4UD6ZEqJCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5 # nGctxVEO6mJcPxaYiyA/4gcaMvnMMUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tO # i3/FNSteo7/rvH0LQnvUU3Ih7jDKu3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbM # UVbonXCUbKw5TNT2eb+qGHpiKe+imyk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXj # pKh0NbhOxXEjEiZ2CzxSjHFaRkMUvLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh # 0EPpK+m79EjMLNTYMoBMJipIJF9a6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLax # aj2JoXZhtG6hE6a/qkfwEm/9ijJssv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWw # ymO0eFQF1EEuUKyUsKV4q7OglnUa2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma # 7kng9wFlb4kLfchpyOZu6qeXzjEp/w7FW1zYTRuh2Povnj8uVRZryROj/TCCB3ow # ggVioAMCAQICCmEOkNIAAAAAAAMwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS # b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTExMDcwODIwNTkwOVoX # DTI2MDcwODIxMDkwOVowfjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0 # b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh # dGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKvw+nIQHC6t2G6qghBNNLry # tlghn0IbKmvpWlCquAY4GgRJun/DDB7dN2vGEtgL8DjCmQawyDnVARQxQtOJDXlk # h36UYCRsr55JnOloXtLfm1OyCizDr9mpK656Ca/XllnKYBoF6WZ26DJSJhIv56sI # UM+zRLdd2MQuA3WraPPLbfM6XKEW9Ea64DhkrG5kNXimoGMPLdNAk/jj3gcN1Vx5 # pUkp5w2+oBN3vpQ97/vjK1oQH01WKKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd # 6IlPhBryoS9Z5JA7La4zWMW3Pv4y07MDPbGyr5I4ftKdgCz1TlaRITUlwzluZH9T # upwPrRkjhMv0ugOGjfdf8NBSv4yUh7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOn # qWbsYR9q4ShJnV+I4iVd0yFLPlLEtVc/JAPw0XpbL9Uj43BdD1FGd7P4AOG8rAKC # X9vAFbO9G9RVS+c5oQ/pI0m8GLhEfEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkw # p6uO3+xbn6/83bBm4sGXgXvt1u1L50kppxMopqd9Z4DmimJ4X7IvhNdXnFy/dygo # 8e1twyiPLI9AN0/B4YVEicQJTMXUpUMvdJX3bvh4IFgsE11glZo+TzOE2rCIF96e # TvSWsLxGoGyY0uDWiIwLAgMBAAGjggHtMIIB6TAQBgkrBgEEAYI3FQEEAwIBADAd # BgNVHQ4EFgQUSG5k5VAF04KqFzc3IrVtqMp1ApUwGQYJKwYBBAGCNxQCBAweCgBT # AHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgw # FoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDov # L2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0 # MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKG # Qmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0 # MjAxMV8yMDExXzAzXzIyLmNydDCBnwYDVR0gBIGXMIGUMIGRBgkrBgEEAYI3LgMw # gYMwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # ZG9jcy9wcmltYXJ5Y3BzLmh0bTBABggrBgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwA # XwBwAG8AbABpAGMAeQBfAHMAdABhAHQAZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0B # AQsFAAOCAgEAZ/KGpZjgVHkaLtPYdGcimwuWEeFjkplCln3SeQyQwWVfLiw++MNy # 0W2D/r4/6ArKO79HqaPzadtjvyI1pZddZYSQfYtGUFXYDJJ80hpLHPM8QotS0LD9 # a+M+By4pm+Y9G6XUtR13lDni6WTJRD14eiPzE32mkHSDjfTLJgJGKsKKELukqQUM # m+1o+mgulaAqPyprWEljHwlpblqYluSD9MCP80Yr3vw70L01724lruWvJ+3Q3fMO # r5kol5hNDj0L8giJ1h/DMhji8MUtzluetEk5CsYKwsatruWy2dsViFFFWDgycSca # f7H0J/jeLDogaZiyWYlobm+nt3TDQAUGpgEqKD6CPxNNZgvAs0314Y9/HG8VfUWn # duVAKmWjw11SYobDHWM2l4bf2vP48hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1 # HxS+YWG18NzGGwS+30HHDiju3mUv7Jf2oVyW2ADWoUa9WfOXpQlLSBCZgB/QACnF # sZulP0V3HjXG0qKin3p6IvpIlR+r+0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9az # I2h15q/6/IvrC4DqaTuv/DDtBEyO3991bWORPdGdVk5Pv4BXIqF4ETIheu9BCrE/ # +6jMpF3BoYibV3FWTkhFwELJm3ZbCoBIa/15n8G9bW1qyVJzEw16UM0xggTGMIIE # wgIBATCBlTB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgw # JgYDVQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExAhMzAAAAww6b # p9iy3PcsAAAAAADDMAkGBSsOAwIaBQCggdowGQYJKoZIhvcNAQkDMQwGCisGAQQB # gjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkE # MRYEFOTytRF6T6xEQAGWWR1ww+QVRcjSMHoGCisGAQQBgjcCAQwxbDBqoCiAJgBT # AHQAbwByAGUAQgByAG8AawBlAHIAIABTAGkAZwBuAGkAbgBnoT6APGh0dHA6Ly9l # ZHdlYi9zaXRlcy9JU1NFbmdpbmVlcmluZy9FbmdGdW4vU2l0ZVBhZ2VzL0hvbWUu # YXNweDANBgkqhkiG9w0BAQEFAASCAQC3is9fO4qGPoF5F5EoxOCT6R9JtbJatWgF # j/pkwjlkvGxzS2DaMadEVLz6wpHlDaxhd0XPrU/L2ZnFT6XElp0ooJQ5QeBQOObI # DajcmQ5wYN0HFJLy5bKHHAED7dC7tNrlZd9ipbjuwGInAHomPDSm3NhtHqQ/YRR/ # nMdrnw5JxO9H6xn/gJ/jN7PAMYmFSF8qqWX7XpCsUTLsysfieY49qnlykuUsJWSm # G3/zXG+fFcd0LauTtGNnra7kUjZBrOc/c4x/FEX2rKS7Bw4Y+hOEYUAZM9dk9bGq # SvO+x+5wNUzdpjqxDISE+rWwbf9th4k0dxxtyWvWO9/QSn+zFGPzoYICKDCCAiQG # CSqGSIb3DQEJBjGCAhUwggIRAgEBMIGOMHcxCzAJBgNVBAYTAlVTMRMwEQYDVQQI # EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv # ZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBUaW1lLVN0YW1wIFBD # QQITMwAAALwLLhp7irHHkQAAAAAAvDAJBgUrDgMCGgUAoF0wGAYJKoZIhvcNAQkD # MQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUxDxcNMTcxMjE0MjMxMzA1WjAjBgkq # hkiG9w0BCQQxFgQUfisrcJAWkXrUBa4RB6zt7SSQzPMwDQYJKoZIhvcNAQEFBQAE # ggEAlsZsESzdKjGqb/oUYzI9LwFe5myGvG/alPNJx2Qa3BrY/rI8a5iNr9QYASxh # W2IJSCorT4KgWLyaMDvZB9Q/0NJuj/8cjVSDu0kIm/ouxdNqWFkRZ1FHksFMf1tI # hZPptLlaW7NXKKkEg1BOQt+LXEs8rmTUYvCFG4Lf9TGVP/E9GI7KTZVX1kDpCn1E # m8GWwBcQcCoGzGaJsi34P5PiBw74r5ynFvBFkvXeJXuMTEzTxh4GTmR3/gKPQ7BT # PJUMQCANpE62T47nlBTtF+A96dRywZyJY8m27g/GVDHzVFfX8PF+4/WpN5CQ52DW # dLh1KU/QLkTNgq0W4k5SH+K9QQ== # SIG # End signature block |