Async Server Certificate Status

Microsoft.Dynamics.Retail.AX2012.R2.FP.Monitoring.Monitor.CdxSynchServiceServerCertificateStatus (UnitMonitor)

Finds the certificate in the certificate trust chain, which is closest to expiration and returns information about that certificate.

Knowledge Base article:

Summary

One or more certificates in the certificate trust chain associated with an instance of Async Server is about to expire or has already expired. If a certificate in the chain expires then Async Server clients will not be able to connect to the Async Server.

Default configuration:

Critical state: A certificate in the chain expires in less than 10 days
Warning state: A certificate in the chain expires in less than 20 days
Healthy state: No certificate in the chain expires sooner than 20 days

Configuration

Error Threshold

Number of days before certificate expiration that the monitor should raise an error.

Interval Seconds

Interval between running scripts, in seconds.

Maximum Processing Time

Maximum time spent processing a monitoring script.

Sync Time

Time of day (approximate) to start running the script after the initial run. Specified using a 24-hour clock.

Warning Threshold

Number of days before certificate expiration that the monitor should raise a warning.

Causes

One or more certificates in the certificate trust chain associated with an instance of Async Server is about to expire or has already expired.

Resolutions

Extend the expiration date of the certificate.

View Online Content

Element properties:

Target

Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer

Parent Monitor

System.Health.AvailabilityState

Category

Custom

Enabled

True

Alert Generate

True

Alert Severity

Error

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Microsoft.Dynamics.Retail.AX2012.R2.FP.Monitoring.MonitorType.CertificateStatus

Remotable

False

Accessibility

Public

Alert Message

Async Server Certificate Status

One or more Async Server certificates in the certificate chain has expired or will expire soon.

When this certificate expires, all asynchronous uploads and downloads between the Async Server and Async Clients that depend on it are affected. Data changes initiated at Retail headquarters will not be available at dependent channels. Recent transactions will also not be uploaded to Microsoft Dynamics AX. However, when connectivity is restored, new jobs will include data that previously failed to upload or download.

Additional information for this disruption:

Certificate subject: {0}

Certificate issuer: {1}

Certificate thumbprint: {2}

Number of days to certificate expiration: {3}

RunAs

Default

Source Code:

<UnitMonitor ID="Microsoft.Dynamics.Retail.AX2012.R2.FP.Monitoring.Monitor.CdxSynchServiceServerCertificateStatus" Accessibility="Public" Enabled="true" Target="Base!Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer" ParentMonitorID="Health!System.Health.AvailabilityState" Remotable="false" Priority="Normal" TypeID="Microsoft.Dynamics.Retail.AX2012.R2.FP.Monitoring.MonitorType.CertificateStatus" ConfirmDelivery="true">

  <Category>Custom</Category>

  <AlertSettings AlertMessage="Microsoft.Dynamics.Retail.AX2012.R2.FP.Monitoring.Monitor.CdxSynchServiceServerCertificateStatus_AlertMessageResourceID">

    <AlertOnState>Error</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>Error</AlertSeverity>

    <AlertParameters>

      <AlertParameter1>$Data/Context/Property[@Name='Subject']$</AlertParameter1>

      <AlertParameter2>$Data/Context/Property[@Name='Issuer']$</AlertParameter2>

      <AlertParameter3>$Target/Property[Type="Base!Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer"]/ServerCertificateThumbprint$</AlertParameter3>

      <AlertParameter4>$Data/Context/Property[@Name='TimeToExpireDays']$</AlertParameter4>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="UIGeneratedOpStateIde85011a98a1444368856383d75c16a87" MonitorTypeStateID="Healthy" HealthState="Success"/>

    <OperationalState ID="UIGeneratedOpStateIde4e4ade3b211491284cd759fda36496a" MonitorTypeStateID="Warning" HealthState="Warning"/>

    <OperationalState ID="UIGeneratedOpStateIdf02865f8ce56425c8e1e89f390266a61" MonitorTypeStateID="Error" HealthState="Error"/>

  </OperationalStates>

  <Configuration>

    <IntervalSeconds>3600</IntervalSeconds>

    <CertificateRootStore>$Target/Property[Type="Base!Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer"]/ServerCertificateRootStore$</CertificateRootStore>

    <CertificateStore>$Target/Property[Type="Base!Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer"]/ServerCertificateStore$</CertificateStore>

    <Thumbprint>$Target/Property[Type="Base!Microsoft.Dynamics.Retail.AX2012.R2.FP.Base.Class.CdxSynchServiceServer"]/ServerCertificateThumbprint$</Thumbprint>

    <WarningThreshold>20</WarningThreshold>

    <ErrorThreshold>10</ErrorThreshold>

    <TimeoutSeconds>300</TimeoutSeconds>

  </Configuration>

</UnitMonitor>