mirror of
https://github.com/hanzoai/porto.git
synced 2026-11-03 18:08:27 +00:00
24 lines
1.3 KiB
Go
24 lines
1.3 KiB
Go
// Package telemetry provides http.Handler middleware for request logging and
|
|
// request metrics, plus the ResponseCapture writer they rely on to observe
|
|
// the status code and body size of a response.
|
|
//
|
|
// h := telemetry.NewRequestLogger(next, time.Millisecond, logger,
|
|
// telemetry.WithLoggerSkipPaths([]telemetry.LoggerSkipPath{{Path: "/healthz", Agent: "*"}}))
|
|
// h = telemetry.NewRequestMetrics(h) // reports the caller role
|
|
// h = identity.NewContextHandler(h, mapper)
|
|
// h = telemetry.NewRequestMetrics(h) // records every response
|
|
//
|
|
// A NewRequestMetrics nested inside another records nothing and passes the
|
|
// role of its request's identity to the outer one, so the outer handler
|
|
// also counts the responses of the identity handler (as guest). The outer
|
|
// handler also records a request whose handler panics, with the status it
|
|
// had sent or 500, and lets the panic continue.
|
|
//
|
|
// Metrics are emitted through porto/metricskey (HTTPReqPerf, HTTPReqByRole)
|
|
// keyed by method, status and route template. The restserver Router records
|
|
// the template of the route it dispatches to with SetRoute; requests without
|
|
// one are labelled UnknownRoute, and non-standard methods OtherMethod, so no
|
|
// label value is copied from the request. LoggerSkipPath entries are also
|
|
// reused by restserver/authz to suppress access logs; see ShouldSkip.
|
|
package telemetry
|