Microsoft.AzLocal.CSSTools

1.2608.31.1

modules/AzStack.Insights/AzStack.Insights.Observability.psm1

                                <################################################################

#                                                               #

#   Copyright (C) Microsoft Corporation. All rights reserved.   #

#                                                               #

################################################################>

#################################################################

#                                                               #

#                 STARTUP ACTIONS ON IMPORT                     #

#                                                               #

#################################################################

Import-Module $PSScriptRoot\..\AzStack.Common\AzStack.Common.psm1

# import the observability module which contains the logging events

# if we cannot find the module, we will not be able to write logs

# Note: no -Force here. AzStack.Common (imported above) already imports AzStack.Observability

# itself, so by this point the module -- including its `enum TraceLevel` -- is very likely

# already loaded. Re-importing with -Force would re-run the whole module script and redeclare

# the enum as a distinct type identity, which breaks CommandMetadata resolution for any already

#-JIT'd reference to the original [TraceLevel] type (observed as Pester's Mock infrastructure

# failing with "Unable to find type [TraceLevel]" when mocking Write-AzsSupportLog). A plain

# Import-Module is idempotent when the module is already loaded, so this still correctly detects

# and reports a genuinely missing/broken module via the catch below.

if (Test-Path -Path "$($PSScriptRoot)\..\AzStack.Observability" -PathType Container) {

    try {

        # Try to import the module

        Import-Module -Name "$($PSScriptRoot)\..\AzStack.Observability\AzStack.Observability.psm1" -DisableNameChecking -ErrorAction Stop

        $script:LoggingEnabled = $true

    }

    catch {

        # If the import fails, write an error message and set logging to false

        Write-Warning "Failed to import AzStack.Observability module due to $($_.Exception.Message) Logging will not be enabled."

        $script:LoggingEnabled = $false

    }

}

else {

    $script:LoggingEnabled = $false

}

# Tracks the health of the Send-InsightTelemetryEvent (CSSToolsEventWriter) pipeline specifically,

# independent of $script:LoggingEnabled above. $script:LoggingEnabled only means "did

# AzStack.Observability import succeed" (needed here so the CSSToolsEventWriter/InsightRuleTelemetryEvent

# etc. .NET types are loaded) and is never toggled again at runtime. Write-AzsSupportLog now lives in

# AzStack.Observability itself and manages its own ETW dispatch health independently via that module's

# $script:EtwLoggingEnabled, so it is unaffected by either flag in this module.

$script:TelemetryEventLoggingEnabled = $true

#################################################################

#                                                               #

#                    ENUMS AND CLASSES                          #

#                                                               #

#################################################################

#################################################################

#                                                               #

#                         FUNCTIONS                             #

#                                                               #

#################################################################

function Get-InsightRuleStatusCount {

    [CmdletBinding()]

    param (

        [AllowNull()]

        [object[]]$Rules,

        [Parameter(Mandatory = $true)]

        [ValidateSet('INFO', 'SUCCESS', 'WARNING', 'FAILURE', 'UNKNOWN', 'NOT_APPLICABLE')]

        [string]$Status

    )

    return @($Rules | Where-Object { $_.Status -eq $Status }).Count

}

function Get-InsightDurationSeconds {

    [CmdletBinding()]

    param (

        [AllowNull()]

        $Duration

    )

    if ($Duration -isnot [TimeSpan]) {

        return 0

    }

    return [int][Math]::Floor($Duration.TotalSeconds)

}

function Send-InsightTelemetryEvent {

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        $TelemetryEvent

    )

    [Microsoft.AzureStack.CSSTools.Observability.Events.CSSToolsEventWriter]::EmitTelemetryEvent($TelemetryEvent)

}

function Write-InsightEvent {

    <#

    .SYNOPSIS

        Writes an insight event using CSSToolsEventWriter.

    .PARAMETER Insight

        The Insight object containing data.

    .PARAMETER Version

        The version of the insights module. Defaults to the current CSSTools module version.

    .DESCRIPTION

        This function writes an insight event using the CSSToolsEventWriter.

        It supports both Rule and Analyzer insight types.

        For Rule insights, events are only written for non-INFO and non-SUCCESS statuses to reduce event volume.

        For Analyzer insights, a summary of rule statuses is included in the event.

    .EXAMPLE

        PS> Write-InsightEvent -Insight $insightObject

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        [PSCustomObject]$Insight,

        [Parameter(Mandatory = $false)]

        [string]$Version = $Global:CSSTools_AzsSupport.ModuleVersion

    )

    # check if logging is enabled, if not, return without writing any events

    if (-NOT ($script:LoggingEnabled) -or -NOT ($script:TelemetryEventLoggingEnabled)) {

        return

    }

    $insightTelemetryEvent = $null

    try {

        switch ($Insight.InsightType) {

            'Rule' {

                # To reduce the total number of events sent, we only write events for actionable rule outcomes.

                if ($Insight.Status -eq "INFO" -or $Insight.Status -eq "SUCCESS" -or $Insight.Status -eq "NOT_APPLICABLE") {

                    return

                }

                $insightTelemetryEvent = [Microsoft.AzureStack.CSSTools.Observability.Events.InsightRuleTelemetryEvent]::new(

                    $Insight.Name,

                    $Insight.Id,

                    $Insight.CorrelationId,

                    $Insight.Status,

                    $Insight.ErrorCode,

                    (Get-InsightDurationSeconds -Duration $Insight.Duration),

                    $Version,

                    $Insight.ScriptStackTrace,

                    $Insight.Analyzer

                )

            }

            'Analyzer' {

                # Summarize the rules

                $rules = @($Insight.Rules | Where-Object { $null -ne $_ })

                $ruleCount = $rules.Count

                $failedRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'FAILURE'

                $warningRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'WARNING'

                $successRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'SUCCESS'

                $infoRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'INFO'

                $unknownRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'UNKNOWN'

                $notApplicableRuleCount = Get-InsightRuleStatusCount -Rules $rules -Status 'NOT_APPLICABLE'

                $insightTelemetryEvent = [Microsoft.AzureStack.CSSTools.Observability.Events.InsightAnalyzerTelemetryEvent]::new(

                    $Insight.Name,

                    $Insight.Id,

                    $Insight.CorrelationId,

                    $Insight.Status,

                    (Get-InsightDurationSeconds -Duration $Insight.Duration),

                    $Version,

                    $Insight.ScriptStackTrace,

                    $ruleCount,

                    $failedRuleCount,

                    $warningRuleCount,

                    $successRuleCount,

                    $infoRuleCount,

                    $unknownRuleCount,

                    $notApplicableRuleCount,

                    $Insight.Component

                )

            }

            default {

                return

            }

        }

    }

    catch {

        try {

            $_ | Write-AzsSupportLog -Level 'Exception'

        }

        catch { }

        return

    }

    try {

        Send-InsightTelemetryEvent -TelemetryEvent $insightTelemetryEvent

    }

    catch {

        # The event writer itself is unusable (e.g. disposed instance). Disable only the

        # telemetry-event pipeline for the remainder of the session -- this must not affect

        # Write-AzsSupportLog's unrelated ETW dispatch, which lives in a different module.

        $script:TelemetryEventLoggingEnabled = $false

    }

}

function Write-RemediationEvent {

    <#

    .SYNOPSIS

        Writes a remediation event using CSSToolsEventWriter.

    .PARAMETER Remediation

        The remediation result object returned by a remediation script.

    .PARAMETER Version

        The version of the insights module. Defaults to the current CSSTools module version.

    .DESCRIPTION

        This function writes a remediation event using the CSSToolsEventWriter.

        It creates an InsightRemediationEvent from the remediation result and emits it as an ETW event.

    .EXAMPLE

        PS> Write-RemediationEvent -Remediation $remediationObject

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        [PSCustomObject]$Remediation,

        [Parameter(Mandatory = $false)]

        [string]$Version = $Global:CSSTools_AzsSupport.ModuleVersion

    )

    # check if logging is enabled, if not, return without writing any events

    if (-NOT ($script:LoggingEnabled) -or -NOT ($script:TelemetryEventLoggingEnabled)) {

        return

    }

    $remediationEvent = $null

    try {

        $remediationEvent = [Microsoft.AzureStack.CSSTools.Observability.Events.InsightRemediationEvent]::new(

            $Remediation.Name,

            $Remediation.Status.ToString(),

            [bool]$Remediation.ChangesApplied,

            $Remediation.ScriptStackTrace,

            $Version

        )

    }

    catch {

        try {

            $_ | Write-AzsSupportLog -Level 'Exception'

        }

        catch { }

        return

    }

    try {

        Send-InsightTelemetryEvent -TelemetryEvent $remediationEvent

    }

    catch {

        # See Write-InsightEvent's identical catch above -- keep this pipeline's failures scoped

        # to $script:TelemetryEventLoggingEnabled only.

        $script:TelemetryEventLoggingEnabled = $false

    }

}

Export-ModuleMember -Function Write-InsightEvent

Export-ModuleMember -Function Write-RemediationEvent

# SIG # Begin signature block

# MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAhpM+Qy8gvZNy9

# BsWjwwHlZMM/59o6Fp/InSr+kATAOaCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1

# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8

# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg

# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4

# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R

# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk

# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw

# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg

# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0

# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh

# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9

# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H

# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3

# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n

# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs

# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo

# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb

# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6

# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z

# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v

# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs

# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA

# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl

# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow

# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo

# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh

# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h

# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd

# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp

# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t

# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5

# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs

# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK

# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5

# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW

# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ

# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC

# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB

# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI

# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4

# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh

# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q

# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU

# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb

# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z

# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u

# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW

# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV

# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ

# KoZIhvcNAQkEMSIEINvJI0PSMCKlbibHBYvmQUQ1DqTw6uvgZRM/VHLIxWdHMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAtewyI/WRgT5FHO8d

# Z9Q4UKLpqTkbiXhlmFlq984GLGV3jx8+L3edxnEsf5DLfz9UC27/SZb9CW4jL60q

# BtssWTLpQpsd5p9+s/82JpUacQgP2epuxxlUVf/olKZxiFbnt30yM4y6ZAfx5ob5

# mKl9+YLMyEMFGFsFqMlmgH6dEnmq8KJIixhRjA2dXC6ZwjR0kWl+BDIfRmGjSiHT

# aqHdb1nJER16yDEgl+F7SHQnfti4rR9XeoYBqEfhaSlWXWJaYBAiobsVXhWic4iQ

# SNj2rivxHPYEan6GE8tk+P2/cCuivtK9pe1yPP4kAyWyMY06Hks2w7BRbhhwh4Fh

# tE+F6aGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w

# ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9

# MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCASdIHczYb74tIL

# 0dRtx2fdaBm4xsOAAJZj2DQ6loPMQQIGaoTzK/CfGBMyMDI2MDkwMjE1MjYxMi45

# NDNaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw

# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046REMwMC0wNUUwLUQ5NDcxJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT

# MwAAAiQ7hCGwLKxkIgABAAACJDANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTM5NTlaFw0yNzA1MTcxOTM5NTla

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046REMwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCj

# 6W3UaQ2Zr4hNvSy7j7UMPFVys7aExGB+JFwykzzXg3jayYm9gOLXJ7tNhU2emhrL

# QCOZcgLvz6FkqmghzQxzmkgKtLYiKaEzhogO/ce0lThdLNdVtMwQOYgo+XtXAZcV

# iBX4LcHk38RusZiF7wxSa5t/Lxic04+Z/hly1gJQpIeFDqp4a9PuLt8rsfH05vW9

# pU9uriGdDxfJXn/lc49CxbXqA3EX17L24bc6t+mFuPDAJKKpai3XXqF2nJlpTPfd

# rA29sWTSNKig9CtBC5tzQj0flbsa/4wqO9u+RkuwpZb3b7qnW5FdFrDR1vQmXfjl

# yUP9ZO38839NwSuiHtvsFCNkTNIX8OL5XVq1nsKyu//GeIZ9YuxsfLBedqG024PD

# ERyrAs0pvfUWOLapVQajHPoCnuNSKvbEh7s5IQ0YgupGji+H7rIDx2/mIEI+6Q8W

# wBtk3Yxyhjj0GXw909i0EkTkVyy+1yADjwSC8bw2qM4+Mc4hyytlZzSc0IPUBq1Y

# GnYwCjIwa5/lMW0pFn/HpJdB6XeMuTtYTOpaPoo64FjQryLXWjd4ovpw5lOw7X+v

# 3E9kwN9VBC+wJESBECC1gZMCS5TaVwfE1w4pnXXb1qT9bjgRsPg4dklruUTdon/3

# SNt0a0Q5Nc2Ul+rMlQxXoP9isXwMNnKO5JJkqRDRVQIDAQABo4IBSTCCAUUwHQYD

# VR0OBBYEFHMfkX1u/zJLCMe0gqYitx1tAHeoMB8GA1UdIwQYMBaAFJ+nFV0AXmJd

# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l

# AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA

# A4ICAQA+wHSbmhIpM8CRVZ4tk624hQ+LdZXE4qoeQui77CeNa3jq1FOzi7MRKkko

# 6diEDHXPNWvAagxastCewPzm5TCNh1s4qCHh4R2G/r48wU/Mpc68/WDmJy5CIQn/

# Fwps1sbNUEu7Bzg004qULIVJ963jo/am4xwKgwh+vSVL7/dhsfT7dvhpRddbYLQT

# HZgwuNB6QhcEEsgogLVwNRj37VEWZDiwoMdxyC7YYrQu6MCVtizHnOtkSX7FqIoi

# 6jlcfqfo619uDH9r8k2qAOHCeEAqKXKymIXDMcGGlEdDFbYiDZgPCBM0IHgAeilU

# Son07wjHu0e0ssBmtBafPb4Gd+5FuRnWG3XGe91NCpLKqmFa/4GkVz9OMzZUg8oc

# zxC/4JT3Hf45JEtszToXwNskV3JNCcu2IItr6SJHmi3EDVADDRSNhdzFRpYmplGE

# lPl5GRoPtJiDEvRIbv5MFKIw2x9gnehf5IvBjC4ZkBg+4GTpqGE3mmnzF3nIekOk

# X4ug0/0mN2CSarhuSi9NmHIOpUN2eQHUtgTb/+Gmq7gktCMwIq/JOCYIiTYqpv1o

# bjAGKdWMPCrlSyNAs0jZYzkha535158NMx+wBGvsfFoVsCMG5Ocp6vW6CXyuWRbU

# VqMU1OrQbHfdyzJpbhJC1PbAZIyJCbN+VBgDTAzTKY8w4ISSwTCCB3EwggVZoAMC

# AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy

# NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9

# DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2

# Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N

# 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc

# ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ

# j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk

# lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy

# L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M

# 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX

# pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU

# HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode

# 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA

# ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE

# FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB

# MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE

# AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB

# /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug

# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N

# aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG

# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv

# b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt

# 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP

# MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++

# Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9

# QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2

# wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR

# AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z

# bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx

# t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3

# Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN

# uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z

# cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB

# yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc

# TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU

# U1MgRVNOOkRDMDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T

# dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCmCPHbmseASfe//bGtX9eQG+0+

# 46CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3

# DQEBCwUAAgUA7kKNDTAiGA8yMDI2MDkwMjExNTQ1M1oYDzIwMjYwOTAzMTE1NDUz

# WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuQo0NAgEAMAcCAQACAhOiMAcCAQAC

# AhM0MAoCBQDuQ96NAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg

# CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAKGoyPgQ

# OjxHVTKA5nbWvwgSnS3rRAneJK4isv50fiTAST1aB3N4FGS9qV3XSvqD45f+tEm8

# jXL8OlRy46/CKjUTZjYJ6PygWP4Bghu65UcDaT16oK+mB9abEp/JlTTLABkmxLJ/

# ijJTG7sghB6648tZJwH2IK12zfnh3R1PvFF+hk+zYzpuF/rKqA/IwWLtIZICNDtk

# h8OtMdmIBwdxJJTj0xMETYK/fjAGtgQ4Wrb57aAJi8NikaU86k5SGJlkHO99/Cwx

# Abasao1yQ0E+UCESuqAt0bWMgHuapHIi/NrJaXCCwFLf8OeBf+fnAK5kvKxjhwfT

# RZclifv+nQiD738xggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ

# Q0EgMjAxMAITMwAAAiQ7hCGwLKxkIgABAAACJDANBglghkgBZQMEAgEFAKCCAUow

# GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCCVJv0X

# YR/bjzdSfKhfIYawG0ouLD6aTXxJrOnZQJjMOzCB+gYLKoZIhvcNAQkQAi8xgeow

# gecwgeQwgb0EIEghPTdqm/dRyZ0BczXcdloVEqICdcmpVNbH9CEVzWSOMIGYMIGA

# pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIkO4QhsCysZCIA

# AQAAAiQwIgQgFviCf9vwcqE+ioUxOHYbpBuH/v4Y/KHfv4JkM/oYl5kwDQYJKoZI

# hvcNAQELBQAEggIAIeG8OB9rauov0EM7kzRboTqdPCDSy0nLtxbvX+yXfL4jWofc

# yBmt6ORYFEwlzM3N1CyN7Z0zZvk3hvfwn9b9+HXSaucfsLUFO36YkXh8bYBXLEuc

# lN5HWXgMZxxNAmd7ocw5+8UwFo1Srg3Z2LsSGLp2eT3h7fl8qgy5x8wpV7LPBlZ2

# G88wU3p1m/o9fuZQtxSAJIv5TuEeomAaoOjtuCrkoXBq19LuMLpK1ttDv+velbXl

# zqpcCfpEtT6FTh5P/q7QcMPNPSRuvPVqfzPYcAvATJLM7sP9YIg08iJ93VPbsktI

# yAkbDDppOAPif0bwQeCiWCbAG8oPuTFtYl44wY/gT0IVjTQfmwN4gpP7PcK5T+VJ

# EsmBuYxp3zAElTXfS/OcZ+eTobnRbOrQOd4urzAJSDKNkNmq97c4QWDomhNQZfLR

# pRbuIhETetOKs4ruc8kYPQl/7OVl83onkGxDnvPepavT0d1KRTjr+l8sFxckPdmq

# ys8MDz5O2NME1y7x6qkI4cBx98Oiw0vRJfdYV548Ybc9P/gDw1DMJ4OoLNRrwGae

# WYMQsxG4ichpWxnl9k+D5QguzTgnjUu54ZKPthr4f2b8ZJVukdtCQv1Ck4aq5RlC

# Gh+kgjhU0klszOOKn+6IgceUCcjfgaw3FC5/0l2H4GtWST77wevYrVotA0I=

# SIG # End signature block