Documentation
¶
Overview ¶
Package upstreamwarn hands what an API connection's upstream answered to whatever records upstream warnings (#2486): a Deprecation or Sunset header, and a 404 or 410 from an operation that answered before. The outbound chain calls Observe for every answer an API connection receives, the way it feeds internal/connstate; the API gateway marks the request with the catalog operation it addresses, and an answer to a request with no operation is not observed. The operation is the catalog's operation id or "METHOD template", never the concrete path, which can carry a filled secret.
It holds no recorder of its own: the platform installs one with SetObserver once its database is open, and until then every answer is passed over.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Observe ¶
Observe hands one answer to the installed recorder when the request named an operation. A transport failure (status 0) says nothing about the operation and is passed over.
func SetObserver ¶
func SetObserver(o Observer)
SetObserver installs the recorder every answer is handed to; nil removes it.