Telemetry.ps1
|
# Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. # 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:GHTelemetryClient = $null 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/PowerShellForGitHub .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 the "DisablePiiProtection" configuration value is $false. If it's $true, "Hello World" will be returned. .OUTPUTS System.String - A SHA512 hash of PlainText will be returned if the "DisablePiiProtection" configuration value is $false, otherwise PlainText will be returned untouched. #> [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory)] [AllowNull()] [AllowEmptyString()] [string] $PlainText ) if (Get-GitHubConfiguration -Name DisablePiiProtection) { 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/PowerShellForGitHub .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/PowerShellForGitHub .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/PowerShellForGitHub .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/PowerShellForGitHub .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("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:GHTelemetryClient) { if (-not (Get-GitHubConfiguration -Name SuppressTelemetryReminder)) { Write-Log -Message 'Telemetry is currently enabled. It can be disabled by calling "Set-GitHubConfiguration -DisableTelemetry". Refer to USAGE.md#telemetry for more information. Stop seeing this message in the future by calling "Set-GitHubConfiguration -SuppressTelemetryReminder".' } Write-Log -Message "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:GHTelemetryClient = New-Object Microsoft.ApplicationInsights.TelemetryClient $script:GHTelemetryClient.InstrumentationKey = (Get-GitHubConfiguration -Name ApplicationInsightsKey) $script:GHTelemetryClient.Context.User.Id = $username $script:GHTelemetryClient.Context.Session.Id = [System.GUID]::NewGuid().ToString() $script:GHTelemetryClient.Context.Properties['Username'] = $username $script:GHTelemetryClient.Context.Properties['DayOfWeek'] = (Get-Date).DayOfWeek $script:GHTelemetryClient.Context.Component.Version = $MyInvocation.MyCommand.Module.Version.ToString() } return $script:GHTelemetryClient } 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/PowerShellForGitHub .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("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 (Get-GitHubConfiguration -Name DisableTelemetry) { Write-Log -Message "Telemetry has been disabled via configuration. Skipping reporting event [$EventName]." -Level Verbose return } Write-InvocationLog -ExcludeParameter @('Properties', 'Metrics') try { $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus $propertiesDictionary = New-Object 'System.Collections.Generic.Dictionary[string, string]' $propertiesDictionary['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 -Message "Set-TelemetryEvent failed:" -Exception $_ -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/PowerShellForGitHub .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("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 (Get-GitHubConfiguration -Name DisableTelemetry) { Write-Log -Message "Telemetry has been disabled via configuration. Skipping reporting exception." -Level Verbose return } Write-InvocationLog -ExcludeParameter @('Exception', 'Properties', 'NoFlush') try { $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus $propertiesDictionary = New-Object 'System.Collections.Generic.Dictionary[string,string]' $propertiesDictionary['Message'] = $Exception.Message $propertiesDictionary['HResult'] = "0x{0}" -f [Convert]::ToString($Exception.HResult, 16) $Properties.Keys | ForEach-Object { $propertiesDictionary[$_] = $Properties[$_] } if (-not [String]::IsNullOrWhiteSpace($ErrorBucket)) { $propertiesDictionary['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 -Message "Set-TelemetryException failed:" -Exception $_ -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/PowerShellForGitHub .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("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 ) Write-InvocationLog if (Get-GitHubConfiguration -Name DisableTelemetry) { Write-Log -Message "Telemetry has been disabled via configuration. Skipping flushing of the telemetry client." -Level Verbose return } $telemetryClient = Get-TelemetryClient -NoStatus:$NoStatus try { $telemetryClient.Flush() } catch [System.Net.WebException] { Write-Log -Message "Encountered exception while trying to flush telemetry events:" -Exception $_ -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 Write-Log -Level Warning -Exception $_ -Message @( "Encountered a problem while trying to record telemetry events.", "This is non-fatal, but it would be helpful if you could report this problem", "to the PowerShellForGitHub team for further investigation:") } } # SIG # Begin signature block # MIIdkgYJKoZIhvcNAQcCoIIdgzCCHX8CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB # gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR # AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUwB+IEQT7C9dphzgqKgnPHpyJ # m2qgghhuMIIE2jCCA8KgAwIBAgITMwAAAQii+Uk6wLzpWAAAAAABCDANBgkqhkiG # 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw # HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTgwODIzMjAyMDI3 # WhcNMTkxMTIzMjAyMDI3WjCByjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEm # MCQGA1UECxMdVGhhbGVzIFRTUyBFU046QTg0MS00QkI0LUNBOTMxJTAjBgNVBAMT # HE1pY3Jvc29mdCBUaW1lLVN0YW1wIHNlcnZpY2UwggEiMA0GCSqGSIb3DQEBAQUA # A4IBDwAwggEKAoIBAQC7nYVW8D1vF9H+Np9rsDfXj5qO3efQTdBKUy8kK5zu2QbT # qQrAtPz32S1pGznILaw9Vroc0RL+bHD+A+3G1+hk35brsgTa1HR/NeHWJc8FXBLz # VkeNz0oZvHJ9WKMLsQlRa298hhG342GRgw222kwOXKFo0GimWuTkiJp24p98iEvg # IYQavN3qSM6giFZONzqwyEJARo9Eu9KHppS2sC7AR8asAZfkBqpdwbw1DnrPcr01 # IimEEVHBqdZPsLhbg0rkIDCy0XajW0HsaisIJgpS3LePUlVnmiio0mEH0s4ASJ/5 # B/sca7/hSOcTclznzJXwSgMgM7/xxKWzZImdQDiZAgMBAAGjggEJMIIBBTAdBgNV # HQ4EFgQUryk+Y1deSQhnMh4mC/394aUdl2QwHwYDVR0jBBgwFoAUIzT42VJGcArt # QPt2+7MrsMM1sw8wVAYDVR0fBE0wSzBJoEegRYZDaHR0cDovL2NybC5taWNyb3Nv # ZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljcm9zb2Z0VGltZVN0YW1wUENBLmNy # bDBYBggrBgEFBQcBAQRMMEowSAYIKwYBBQUHMAKGPGh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2kvY2VydHMvTWljcm9zb2Z0VGltZVN0YW1wUENBLmNydDATBgNV # HSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQUFAAOCAQEAMNTUvMQ68dXnRkqO # LqksPUC9I2MhjMGl4bF2s8xtG/aCP1iW9RdXOe/dWHhbzMTKlBUhxRJsxPv4Ebgp # fH+4Oy3VFiHi3V5HvZlbSAqvd+mmYjpCh4nfwFV4YMfTk09eiHkkriORgYYwacpj # 7rqcV6fuSLchQ+qjvPkQXm090rmnmC3zQaKtRP3p4hd52xCXMUuoYRqeyeS34+3+ # WHWLYKxHo81yTFi/SZc3+sUNOmrWbVzHK3osyTsNS0XF3BHNni19Wt0KlkdnCMFe # Qs99GPcYH3nXKjNaTPQ/c8eVJbJE0brjYTGu78wKUBkpGs40Kbx+VuJ2Eb8VTPaU # aCc3CjCCBgMwggProAMCAQICEzMAAAEEaeLbufuKDYMAAAAAAQQwDQYJKoZIhvcN # AQELBQAwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYG # A1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTAeFw0xODA3MTIy # MDA4NDlaFw0xOTA3MjYyMDA4NDlaMHQxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xHjAcBgNVBAMTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIw # DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJvFlfKX9v8jamydc1lzOJvTtOOE # rY24PiXnoLggWkqRcDjYFKi9msD9DWse7OH8/wQ84mFgrlVqYZL71wB9nuppNtb9 # V3kZl/6EkfbHVa2mrgKK7bGRR1bNSodmRacwGxrtrHtrBdIzgnO+xm8czNToGgUV # AC6Rl7ZLyGFnIovnExJowhcUryZatu5Vc3z1RLMhJwYA67U2+fwmiq0/f0QUw3q7 # I8iL3r4WisEhogIB2X+YkuIxU4+HsZAkmxf6FU3KAWwQbFICopNfYgNBJIxwp3As # jUsv1zNZXP1d4D/X5IQXu30+edOCQ2JUQMibXs9wFDtgPGk/nzfn+BaSM4sCAwEA # AaOCAYIwggF+MB8GA1UdJQQYMBYGCisGAQQBgjdMCAEGCCsGAQUFBwMDMB0GA1Ud # DgQWBBS6F+MlaPS71Xsjpri2fOemgqtXrjBUBgNVHREETTBLpEkwRzEtMCsGA1UE # CxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMRYwFAYDVQQF # Ew0yMzAwMTIrNDM3OTY2MB8GA1UdIwQYMBaAFEhuZOVQBdOCqhc3NyK1bajKdQKV # MFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv # cHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcmwwYQYIKwYBBQUH # AQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp # b3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcnQwDAYDVR0T # AQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAKcWCCzmZIAzoJFuJOzhQkoOV25Hy # O9Kk8NqBW3OOZ0gatsmKB3labM7D/GaYF7K716YWtQNWhXsqfS9ABk6eaddpFBWO # Y/vMgPXbEZxQ7ksCcUxrBwX+Z1PxGbZubizyj9RFKeE2CLIceIEnloeZQhh3lNzG # vJ2k21amNtBDSF9ABH5n6YjYAMfrMv/eCndgA3P+nqHHHfPAsy1hh8jxN4Xc/G08 # SxNKEna1UEpN513zTyHkmBKBgf7pXKj8FIzRAp9l+3Z1t2JTx33ax7pC4m57Jkoj # gjLYjXUeEW+Lf3oG1aofGKVwE+fuaJ0HvAbpiQOWDGriIaslA9i3ARHhxCKWKTF8 # w1VO0BznRcZmAIoVIcTFAXAd4mgBOQ8iIcmoc39w2Cz09WnlSWw5paKpyns51fl3 # bzBzg5bAo4uu5X/dY03aFct7+R3ljsQ6qkr0LUVmn/JeuEkXOePfHUmJYYu6M69e # Quoa1PVRU/GlXZKbh2e4dqsGVeGu1YOvOf8gMYtc5vq1B8+GJ8dBAiM5bVlOLsB4 # rzpJY2zieOAjdtQrqGcAPGVSWDDSeOl47e27KX2iHzjl7FnHk5lF+QCIykR6R9Ym # R83UCcK1epAMPRYWfreU20ZSAEoeuT1pyVFlatU/EcQtN5dfksINMQya1ll38FBI # h4l2k9jzfUqwItgwggYHMIID76ADAgECAgphFmg0AAAAAAAcMA0GCSqGSIb3DQEB # BQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/IsZAEZFgltaWNy # b3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv # cml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0MDMxMzAzMDlaMHcxCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBU # aW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ+h # bLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP7tGn0UytdDAgEesH1VSVFUmUG0KS # rphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySHnfL0Zxws/HvniB3q506jocEjU8qN # +kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUoRi4nrIZPVVIM5AMs+2qQkDBuh/NZ # MJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABKR2YRJylmqJfk0waBSqL5hKcRRxQJ # gp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSfrx54QTF3zJvfO4OToWECtR0Nsfz3 # m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGnMA8GA1UdEwEB/wQFMAMBAf8wHQYD # VR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMPMAsGA1UdDwQEAwIBhjAQBgkrBgEE # AYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQOrIJgQFYnl+UlE/wq4QpTlVnkpKFj # pGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jv # c29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9y # aXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1UdHwRJMEcwRaBDoEGGP2h0dHA6Ly9j # cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL21pY3Jvc29mdHJvb3Rj # ZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYIKwYBBQUHMAKGOGh0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljcm9zb2Z0Um9vdENlcnQuY3J0MBMG # A1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUAA4ICAQAQl4rDXANENt3p # tK132855UU0BsS50cVttDBOrzr57j7gu1BKijG1iuFcCy04gE1CZ3XpA4le7r1ia # HOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV3U+rkuTnjWrVgMHmlPIGL4UD6ZEq # JCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5nGctxVEO6mJcPxaYiyA/4gcaMvnM # MUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tOi3/FNSteo7/rvH0LQnvUU3Ih7jDK # u3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbMUVbonXCUbKw5TNT2eb+qGHpiKe+i # myk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXjpKh0NbhOxXEjEiZ2CzxSjHFaRkMU # vLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh0EPpK+m79EjMLNTYMoBMJipIJF9a # 6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLaxaj2JoXZhtG6hE6a/qkfwEm/9ijJs # sv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWwymO0eFQF1EEuUKyUsKV4q7OglnUa # 2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma7kng9wFlb4kLfchpyOZu6qeXzjEp # /w7FW1zYTRuh2Povnj8uVRZryROj/TCCB3owggVioAMCAQICCmEOkNIAAAAAAAMw # DQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n # dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv # cml0eSAyMDExMB4XDTExMDcwODIwNTkwOVoXDTI2MDcwODIxMDkwOVowfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP # ADCCAgoCggIBAKvw+nIQHC6t2G6qghBNNLrytlghn0IbKmvpWlCquAY4GgRJun/D # DB7dN2vGEtgL8DjCmQawyDnVARQxQtOJDXlkh36UYCRsr55JnOloXtLfm1OyCizD # r9mpK656Ca/XllnKYBoF6WZ26DJSJhIv56sIUM+zRLdd2MQuA3WraPPLbfM6XKEW # 9Ea64DhkrG5kNXimoGMPLdNAk/jj3gcN1Vx5pUkp5w2+oBN3vpQ97/vjK1oQH01W # KKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd6IlPhBryoS9Z5JA7La4zWMW3Pv4y # 07MDPbGyr5I4ftKdgCz1TlaRITUlwzluZH9TupwPrRkjhMv0ugOGjfdf8NBSv4yU # h7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOnqWbsYR9q4ShJnV+I4iVd0yFLPlLE # tVc/JAPw0XpbL9Uj43BdD1FGd7P4AOG8rAKCX9vAFbO9G9RVS+c5oQ/pI0m8GLhE # fEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkwp6uO3+xbn6/83bBm4sGXgXvt1u1L # 50kppxMopqd9Z4DmimJ4X7IvhNdXnFy/dygo8e1twyiPLI9AN0/B4YVEicQJTMXU # pUMvdJX3bvh4IFgsE11glZo+TzOE2rCIF96eTvSWsLxGoGyY0uDWiIwLAgMBAAGj # ggHtMIIB6TAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQUSG5k5VAF04KqFzc3 # IrVtqMp1ApUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG # MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEj # iTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br # aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBe # BggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0 # LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDCB # nwYDVR0gBIGXMIGUMIGRBgkrBgEEAYI3LgMwgYMwPwYIKwYBBQUHAgEWM2h0dHA6 # Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvZG9jcy9wcmltYXJ5Y3BzLmh0bTBA # BggrBgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwAXwBwAG8AbABpAGMAeQBfAHMAdABh # AHQAZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAZ/KGpZjgVHkaLtPY # dGcimwuWEeFjkplCln3SeQyQwWVfLiw++MNy0W2D/r4/6ArKO79HqaPzadtjvyI1 # pZddZYSQfYtGUFXYDJJ80hpLHPM8QotS0LD9a+M+By4pm+Y9G6XUtR13lDni6WTJ # RD14eiPzE32mkHSDjfTLJgJGKsKKELukqQUMm+1o+mgulaAqPyprWEljHwlpblqY # luSD9MCP80Yr3vw70L01724lruWvJ+3Q3fMOr5kol5hNDj0L8giJ1h/DMhji8MUt # zluetEk5CsYKwsatruWy2dsViFFFWDgycScaf7H0J/jeLDogaZiyWYlobm+nt3TD # QAUGpgEqKD6CPxNNZgvAs0314Y9/HG8VfUWnduVAKmWjw11SYobDHWM2l4bf2vP4 # 8hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1HxS+YWG18NzGGwS+30HHDiju3mUv # 7Jf2oVyW2ADWoUa9WfOXpQlLSBCZgB/QACnFsZulP0V3HjXG0qKin3p6IvpIlR+r # +0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9azI2h15q/6/IvrC4DqaTuv/DDtBEyO # 3991bWORPdGdVk5Pv4BXIqF4ETIheu9BCrE/+6jMpF3BoYibV3FWTkhFwELJm3Zb # CoBIa/15n8G9bW1qyVJzEw16UM0xggSOMIIEigIBATCBlTB+MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQgQ29k # ZSBTaWduaW5nIFBDQSAyMDExAhMzAAABBGni27n7ig2DAAAAAAEEMAkGBSsOAwIa # BQCggaIwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFO/0CQ3ldNI1NawL9KcdtLto # JYRVMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBho # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAG7TaKTBM # D+EbdakVju1zRGx+TClsW5W2aGat12ZaCbzqOjiagU8Zz4XtViAaDszV1i7P4TVH # +NFCYy40tMqcbC2Msv8bBvPto+tzKfM1BxnlJR1OzzN1be/7lQ/TVX1aSyE+V/k3 # US9oANG3HuhsCirYquPwrN3pytg65/b06gLC7eQN9im6NvELZnUYISgACyJgw41N # WngcUfQoHyecSuy7jq6M3/2KluihZLRA+QU8qUmZu9hNbVyqv7HSxWINhwM/e2PJ # oi7YaRRddrAkcn+NFwO8OBzylUh4/fPD3RrXn6UXU3+RwGDBruIGXnkq0xh0Oybi # HdiTSDSY1xwU5aGCAigwggIkBgkqhkiG9w0BCQYxggIVMIICEQIBATCBjjB3MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhNaWNy # b3NvZnQgVGltZS1TdGFtcCBQQ0ECEzMAAAEIovlJOsC86VgAAAAAAQgwCQYFKw4D # AhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8X # DTE5MDEwNzE3Mjk0NVowIwYJKoZIhvcNAQkEMRYEFEYJH5w9NKIZiUiSMBAOvDGq # /YwJMA0GCSqGSIb3DQEBBQUABIIBAGwJRveG7shDzz1WOqb/E03WsyFXCs3VtzcZ # InGnGbAuWxjlkAlIYimYqnlk6EM+oq00Md52GZ2u+orUml27BpY56dQiXtgj/GGr # zsphqvG3XhGvr4mks+AIxcoSRMSkRtYB6MoH5Hnh5x06wjmW8L0qaH69Tnz7WZJX # AUcaRfmzoBCtr+LTi8bNp3TsEwyCbcjsQz0nPDuaBFJvPI09I7cB6ERmzRIWxU6B # fKR5vKcE674cxqwYrOcG7q1usuNIImLQyt8me4/JjD6xC/JH6kMo+H8e06sOvDne # wODd8SG1jyF0FgqZKvHFJ4osDrAmFVV6MOpTbeMcEA/EPXJhM9o= # SIG # End signature block |