Gå til indhold

Ecreo.Essentials.ProjectReporter

Ecreo.Essentials.ProjectReporter rapporterer metadata om et Umbraco-projekt til et centralt Ecreo endpoint. Pakken bruges til projektoversigt, versionsindsigt og driftsoverblik på managede Umbraco-installationer.

Installer pakken i dit Umbraco-projekt:

Terminal window
dotnet add package Ecreo.Essentials.ProjectReporter

Pakken registrerer sine services via en Umbraco composer, så den kræver normalt ikke ændringer i Program.cs.

Som udgangspunkt bruger pakken sit standard endpoint. Et custom endpoint kan sættes med konfigurationsnøglen:

{
"Ecreo": {
"Essentials": {
"ProjectReporter": {
"Endpoint": "https://example.com/report"
}
}
}
}
  • En composer registrerer ReportSiteJobService.
  • En recurring background job sender Umbracos telemetry report data som JSON.
  • Resultatet gemmes i Umbracos key/value storage under ReportSiteJobService.
  • En health check viser den seneste reporter-status i Umbraco.

Reporteren sender en POST med Content-Type: application/json.

Body er Umbracos TelemetryReportData, som kommer direkte fra ITelemetryService.GetTelemetryReportDataAsync().

Requesten får disse headers:

Header Værdi
reporter-application-name IHostEnvironment.ApplicationName
reporter-application-url WebRoutingSettings.UmbracoApplicationUrl
reporter-environment-name IHostEnvironment.EnvironmentName
reporter-server-role IServerRoleAccessor.CurrentServerRole

I Development sendes der kun rapporter, hvis Ecreo:Essentials:ProjectReporter:Endpoint er sat.

I andre miljøer bruges den konfigurerede URL eller standard-endpointet https://ec-billing-api.ecreo.dk/kundeversion.

Fejl sluges bevidst og logges på debug-niveau, så drift ikke påvirkes af reporter-endpointet.