.NET API
TraconDiagnosticsReport
Tracon.Abstractions.dllReports the self-diagnostics of the installation.
public sealed record TraconDiagnosticsReport : IEquatable<TraconDiagnosticsReport>Inheritance
Section titled “Inheritance”object ← TraconDiagnosticsReport
Implements
Section titled “Implements”IEquatable<TraconDiagnosticsReport>
Inherited Members
Section titled “Inherited Members”object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”This type does not carry a secret. It has no connection string, API
key, or credential fields. It only carries whether configuration resolved.
TraconDiagnosticsCollector in Tracon.Core creates this report.
It makes no model call and applies no migration. It only reads the current state.
Constructors
Section titled “Constructors”TraconDiagnosticsReport()
Section titled “ TraconDiagnosticsReport()”public TraconDiagnosticsReport()Properties
Section titled “Properties”AgentCount
Section titled “ AgentCount”Gets the number of registered agents. Returns null when the catalog cannot be read.
public required int? AgentCount { get; init; }Property Value
Section titled “Property Value”int?
Remarks
Section titled “Remarks”null and 0 are different. This report must
describe a broken installation. A catalog query fails when
AutoApplyMigrations=false and the schema is not applied yet.
Returning 0 would incorrectly state that no agents exist;
null states that counting failed. The remaining report,
especially TraconDiagnosticsReport.PendingMigrations, is still populated.
AgentSources
Section titled “ AgentSources”Gets the agent sources registered in priority order.
public required IReadOnlyList<AgentSourceDiagnostic> AgentSources { get; init; }Property Value
Section titled “Property Value”IReadOnlyList<AgentSourceDiagnostic>
CanConnect
Section titled “ CanConnect”Gets whether the active SQL provider can connect. Returns true without an SQL provider.
public required bool CanConnect { get; init; }Property Value
Section titled “Property Value”Configuration
Section titled “ Configuration”Gets the resolution status of configuration keys required by registered providers.
public required IReadOnlyList<ConfigurationDiagnostic> Configuration { get; init; }Property Value
Section titled “Property Value”IReadOnlyList<ConfigurationDiagnostic>
ExtensionPoints
Section titled “ ExtensionPoints”Gets the embedding points a host application binds to attach Tracon to its own tenancy, identity, authorization, eventing, and storage.
public required IReadOnlyList<ExtensionPointDiagnostic> ExtensionPoints { get; init; }Property Value
Section titled “Property Value”IReadOnlyList<ExtensionPointDiagnostic>
Remarks
Section titled “Remarks”Fixed length: one entry per embedding point (ITenantContext,
IRunAttributionContext, IToolAuthorizationHandler,
IRunAuthorizationHandler, IRunEventSink,
IAttachmentStorage, IToolApprovalPresenter), never more. Carries no
secret: only the bound implementation’s type name and whether it
is Tracon’s built-in default.
MigrationsUpToDate
Section titled “ MigrationsUpToDate”Gets whether no migrations are pending. Returns true without an SQL provider.
public required bool MigrationsUpToDate { get; init; }Property Value
Section titled “Property Value”ModelProviders
Section titled “ ModelProviders”Gets the last known status of each registered model provider.
public required IReadOnlyList<ProviderDiagnostic> ModelProviders { get; init; }Property Value
Section titled “Property Value”IReadOnlyList<ProviderDiagnostic>
PendingMigrations
Section titled “ PendingMigrations”Gets the pending migration names. The list is empty when there is no SQL provider or all migrations are applied.
public required IReadOnlyList<string> PendingMigrations { get; init; }Property Value
Section titled “Property Value”PersistenceProvider
Section titled “ PersistenceProvider”Gets the name of the active persistence provider, for example PostgreSQL or InMemory.
public required string PersistenceProvider { get; init; }Property Value
Section titled “Property Value”RegisteredPersistenceProviders
Section titled “ RegisteredPersistenceProviders”Gets the number of registered SQL persistence providers. More than 1
indicates a setup defect: the last call wins and silently disables the others.
public required int RegisteredPersistenceProviders { get; init; }Property Value
Section titled “Property Value”ToolCount
Section titled “ ToolCount”Gets the number of registered tools.
public required int ToolCount { get; init; }Property Value
Section titled “Property Value”UiEmbedded
Section titled “ UiEmbedded”Gets whether the management UI has embedded assets.
public required bool UiEmbedded { get; init; }Property Value
Section titled “Property Value”Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(TraconDiagnosticsReport?)
Section titled “ Equals(TraconDiagnosticsReport?)”public bool Equals(TraconDiagnosticsReport? other)Parameters
Section titled “Parameters”other TraconDiagnosticsReport?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(TraconDiagnosticsReport?, TraconDiagnosticsReport?)
Section titled “ operator ==(TraconDiagnosticsReport?, TraconDiagnosticsReport?)”public static bool operator ==(TraconDiagnosticsReport? left, TraconDiagnosticsReport? right)Parameters
Section titled “Parameters”left TraconDiagnosticsReport?
right TraconDiagnosticsReport?
Returns
Section titled “Returns”operator !=(TraconDiagnosticsReport?, TraconDiagnosticsReport?)
Section titled “ operator !=(TraconDiagnosticsReport?, TraconDiagnosticsReport?)”public static bool operator !=(TraconDiagnosticsReport? left, TraconDiagnosticsReport? right)Parameters
Section titled “Parameters”left TraconDiagnosticsReport?
right TraconDiagnosticsReport?