1 <?xml version="1.0"?>
\r
4 <name>Microsoft.Extensions.Diagnostics.HealthChecks.Abstractions</name>
\r
7 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckContext">
\r
9 Health check context. Provides health check registrations to <see cref="M:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck.CheckHealthAsync(Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckContext,System.Threading.CancellationToken)"/>.
\r
12 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckContext.Registration">
\r
14 Gets or sets the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration"/> of the currently executing <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/>.
\r
17 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration">
\r
19 Represent the registration information associated with an <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> implementation.
\r
23 The health check registration is provided as a separate object so that application developers can customize
\r
24 how health check implementations are configured.
\r
27 The registration is provided to an <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> implementation during execution through
\r
28 <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckContext.Registration"/>. This allows a health check implementation to access named
\r
29 options or perform other operations based on the registered name.
\r
33 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.#ctor(System.String,Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck,System.Nullable{Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus},System.Collections.Generic.IEnumerable{System.String})">
\r
35 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration" /> for an existing <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck" /> instance.
\r
37 <param name="name">The health check name.</param>
\r
38 <param name="instance">The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck" /> instance.</param>
\r
39 <param name="failureStatus">
\r
40 The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus" /> that should be reported upon failure of the health check. If the provided value
\r
41 is <c>null</c>, then <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy" /> will be reported.
\r
43 <param name="tags">A list of tags that can be used for filtering health checks.</param>
\r
45 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.#ctor(System.String,Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck,System.Nullable{Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus},System.Collections.Generic.IEnumerable{System.String},System.Nullable{System.TimeSpan})">
\r
47 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration"/> for an existing <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.
\r
49 <param name="name">The health check name.</param>
\r
50 <param name="instance">The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.</param>
\r
51 <param name="failureStatus">
\r
52 The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> that should be reported upon failure of the health check. If the provided value
\r
53 is <c>null</c>, then <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> will be reported.
\r
55 <param name="tags">A list of tags that can be used for filtering health checks.</param>
\r
56 <param name="timeout">An optional <see cref="T:System.TimeSpan"/> representing the timeout of the check.</param>
\r
58 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.#ctor(System.String,System.Func{System.IServiceProvider,Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck},System.Nullable{Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus},System.Collections.Generic.IEnumerable{System.String})">
\r
60 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration"/> for an existing <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.
\r
62 <param name="name">The health check name.</param>
\r
63 <param name="factory">A delegate used to create the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.</param>
\r
64 <param name="failureStatus">
\r
65 The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> that should be reported when the health check reports a failure. If the provided value
\r
66 is <c>null</c>, then <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> will be reported.
\r
68 <param name="tags">A list of tags that can be used for filtering health checks.</param>
\r
70 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.#ctor(System.String,System.Func{System.IServiceProvider,Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck},System.Nullable{Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus},System.Collections.Generic.IEnumerable{System.String},System.Nullable{System.TimeSpan})">
\r
72 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration"/> for an existing <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.
\r
74 <param name="name">The health check name.</param>
\r
75 <param name="factory">A delegate used to create the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.</param>
\r
76 <param name="failureStatus">
\r
77 The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> that should be reported when the health check reports a failure. If the provided value
\r
78 is <c>null</c>, then <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> will be reported.
\r
80 <param name="tags">A list of tags that can be used for filtering health checks.</param>
\r
81 <param name="timeout">An optional <see cref="T:System.TimeSpan"/> representing the timeout of the check.</param>
\r
83 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.Factory">
\r
85 Gets or sets a delegate used to create the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instance.
\r
88 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.FailureStatus">
\r
90 Gets or sets the <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> that should be reported upon failure of the health check.
\r
93 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.Timeout">
\r
95 Gets or sets the timeout used for the test.
\r
98 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.Name">
\r
100 Gets or sets the health check name.
\r
103 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckRegistration.Tags">
\r
105 Gets a list of tags that can be used for filtering health checks.
\r
108 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult">
\r
110 Represents the result of a health check.
\r
113 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.#ctor(Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus,System.String,System.Exception,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object})">
\r
115 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> with the specified values for <paramref name="status"/>,
\r
116 <paramref name="exception"/>, <paramref name="description"/>, and <paramref name="data"/>.
\r
118 <param name="status">A value indicating the status of the component that was checked.</param>
\r
119 <param name="description">A human-readable description of the status of the component that was checked.</param>
\r
120 <param name="exception">An <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Exception"/> representing the exception that was thrown when checking for status (if any).</param>
\r
121 <param name="data">Additional key-value pairs describing the health of the component.</param>
\r
123 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Data">
\r
125 Gets additional key-value pairs describing the health of the component.
\r
128 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Description">
\r
130 Gets a human-readable description of the status of the component that was checked.
\r
133 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Exception">
\r
135 Gets an <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Exception"/> representing the exception that was thrown when checking for status (if any).
\r
138 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Status">
\r
140 Gets a value indicating the status of the component that was checked.
\r
143 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Healthy(System.String,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object})">
\r
145 Creates a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing a healthy component.
\r
147 <param name="description">A human-readable description of the status of the component that was checked. Optional.</param>
\r
148 <param name="data">Additional key-value pairs describing the health of the component. Optional.</param>
\r
149 <returns>A <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing a healthy component.</returns>
\r
151 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Degraded(System.String,System.Exception,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object})">
\r
153 Creates a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing a degraded component.
\r
155 <param name="description">A human-readable description of the status of the component that was checked. Optional.</param>
\r
156 <param name="exception">An <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Exception"/> representing the exception that was thrown when checking for status. Optional.</param>
\r
157 <param name="data">Additional key-value pairs describing the health of the component. Optional.</param>
\r
158 <returns>A <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing a degraged component.</returns>
\r
160 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Unhealthy(System.String,System.Exception,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object})">
\r
162 Creates a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing an unhealthy component.
\r
164 <param name="description">A human-readable description of the status of the component that was checked. Optional.</param>
\r
165 <param name="exception">An <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult.Exception"/> representing the exception that was thrown when checking for status. Optional.</param>
\r
166 <param name="data">Additional key-value pairs describing the health of the component. Optional.</param>
\r
167 <returns>A <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckResult"/> representing an unhealthy component.</returns>
\r
169 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport">
\r
171 Represents the result of executing a group of <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/> instances.
\r
174 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.#ctor(System.Collections.Generic.IReadOnlyDictionary{System.String,Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry},System.TimeSpan)">
\r
176 Create a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/> from the specified results.
\r
178 <param name="entries">A <see cref="T:System.Collections.Generic.IReadOnlyDictionary`2"/> containing the results from each health check.</param>
\r
179 <param name="totalDuration">A value indicating the time the health check service took to execute.</param>
\r
181 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.#ctor(System.Collections.Generic.IReadOnlyDictionary{System.String,Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry},Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus,System.TimeSpan)">
\r
183 Create a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/> from the specified results.
\r
185 <param name="entries">A <see cref="T:System.Collections.Generic.IReadOnlyDictionary`2"/> containing the results from each health check.</param>
\r
186 <param name="status">A <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> representing the aggregate status of all the health checks.</param>
\r
187 <param name="totalDuration">A value indicating the time the health check service took to execute.</param>
\r
189 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.Entries">
\r
191 A <see cref="T:System.Collections.Generic.IReadOnlyDictionary`2"/> containing the results from each health check.
\r
194 The keys in this dictionary map the name of each executed health check to a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry"/> for the
\r
195 result data returned from the corresponding health check.
\r
198 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.Status">
\r
200 Gets a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus"/> representing the aggregate status of all the health checks. The value of <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.Status"/>
\r
201 will be the most severe status reported by a health check. If no checks were executed, the value is always <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Healthy"/>.
\r
204 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport.TotalDuration">
\r
206 Gets the time the health check service took to execute.
\r
209 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry">
\r
211 Represents an entry in a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/>. Corresponds to the result of a single <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck"/>.
\r
214 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.#ctor(Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus,System.String,System.TimeSpan,System.Exception,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object})">
\r
216 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry"/> with the specified values for <paramref name="status"/>, <paramref name="exception"/>,
\r
217 <paramref name="description"/>, and <paramref name="data"/>.
\r
219 <param name="status">A value indicating the health status of the component that was checked.</param>
\r
220 <param name="description">A human-readable description of the status of the component that was checked.</param>
\r
221 <param name="duration">A value indicating the health execution duration.</param>
\r
222 <param name="exception">An <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Exception"/> representing the exception that was thrown when checking for status (if any).</param>
\r
223 <param name="data">Additional key-value pairs describing the health of the component.</param>
\r
225 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.#ctor(Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus,System.String,System.TimeSpan,System.Exception,System.Collections.Generic.IReadOnlyDictionary{System.String,System.Object},System.Collections.Generic.IEnumerable{System.String})">
\r
227 Creates a new <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry"/> with the specified values for <paramref name="status"/>, <paramref name="exception"/>,
\r
228 <paramref name="description"/>, and <paramref name="data"/>.
\r
230 <param name="status">A value indicating the health status of the component that was checked.</param>
\r
231 <param name="description">A human-readable description of the status of the component that was checked.</param>
\r
232 <param name="duration">A value indicating the health execution duration.</param>
\r
233 <param name="exception">An <see cref="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Exception"/> representing the exception that was thrown when checking for status (if any).</param>
\r
234 <param name="data">Additional key-value pairs describing the health of the component.</param>
\r
235 <param name="tags">Tags associated with the health check that generated the report entry.</param>
\r
237 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Data">
\r
239 Gets additional key-value pairs describing the health of the component.
\r
242 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Description">
\r
244 Gets a human-readable description of the status of the component that was checked.
\r
247 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Duration">
\r
249 Gets the health check execution duration.
\r
252 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Exception">
\r
254 Gets an <see cref="T:System.Exception"/> representing the exception that was thrown when checking for status (if any).
\r
257 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Status">
\r
259 Gets the health status of the component that was checked.
\r
262 <member name="P:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReportEntry.Tags">
\r
264 Gets the tags associated with the health check.
\r
267 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus">
\r
269 Represents the reported status of a health check result.
\r
273 A status of <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> should be considered the default value for a failing health check. Application
\r
274 developers may configure a health check to report a different status as desired.
\r
277 The values of this enum or ordered from least healthy to most healthy. So <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Degraded"/> is
\r
278 greater than <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy"/> but less than <see cref="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Healthy"/>.
\r
282 <member name="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Unhealthy">
\r
284 Indicates that the health check determined that the component was unhealthy, or an unhandled
\r
285 exception was thrown while executing the health check.
\r
288 <member name="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Degraded">
\r
290 Indicates that the health check determined that the component was in a degraded state.
\r
293 <member name="F:Microsoft.Extensions.Diagnostics.HealthChecks.HealthStatus.Healthy">
\r
295 Indicates that the health check determined that the component was healthy.
\r
298 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck">
\r
300 Represents a health check, which can be used to check the status of a component in the application, such as a backend service, database or some internal
\r
304 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheck.CheckHealthAsync(Microsoft.Extensions.Diagnostics.HealthChecks.HealthCheckContext,System.Threading.CancellationToken)">
\r
306 Runs the health check, returning the status of the component being checked.
\r
308 <param name="context">A context object associated with the current execution.</param>
\r
309 <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken"/> that can be used to cancel the health check.</param>
\r
310 <returns>A <see cref="T:System.Threading.Tasks.Task`1"/> that completes when the health check has finished, yielding the status of the component being checked.</returns>
\r
312 <member name="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher">
\r
314 Represents a publisher of <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/> information.
\r
318 The default health checks implementation provided an <c>IHostedService</c> implementation that can
\r
319 be used to execute health checks at regular intervals and provide the resulting <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/>
\r
320 data to all registered <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher"/> instances.
\r
323 To provide an <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher"/> implementation, register an instance or type as a singleton
\r
324 service in the dependency injection container.
\r
327 <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher"/> instances are provided with a <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/> after executing
\r
328 health checks in a background thread. The use of <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher"/> depend on hosting in
\r
329 an application using <c>IWebHost</c> or generic host (<c>IHost</c>). Execution of <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher"/>
\r
330 instance is not related to execution of health checks via a middleware.
\r
334 <member name="M:Microsoft.Extensions.Diagnostics.HealthChecks.IHealthCheckPublisher.PublishAsync(Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport,System.Threading.CancellationToken)">
\r
336 Publishes the provided <paramref name="report"/>.
\r
338 <param name="report">The <see cref="T:Microsoft.Extensions.Diagnostics.HealthChecks.HealthReport"/>. The result of executing a set of health checks.</param>
\r
339 <param name="cancellationToken">The <see cref="T:System.Threading.CancellationToken"/>.</param>
\r
340 <returns>A <see cref="T:System.Threading.Tasks.Task"/> which will complete when publishing is complete.</returns>
\r