type HTTPConv … // ClientResponse returns attributes for an HTTP response received by a client // from a server. The following attributes are returned if the related values // are defined in resp: "http.status.code", "http.response_content_length". // // This does not add all OpenTelemetry required attributes for an HTTP event, // it assumes ClientRequest was used to create the span with a complete set of // attributes. If a complete set of attributes can be generated using the // request contained in resp. For example: // // append(ClientResponse(resp), ClientRequest(resp.Request)...) func (c *HTTPConv) ClientResponse(resp *http.Response) []attribute.KeyValue { … } // ClientRequest returns attributes for an HTTP request made by a client. The // following attributes are always returned: "http.url", "http.flavor", // "http.method", "net.peer.name". The following attributes are returned if the // related values are defined in req: "net.peer.port", "http.user_agent", // "http.request_content_length", "enduser.id". func (c *HTTPConv) ClientRequest(req *http.Request) []attribute.KeyValue { … } // ServerRequest returns attributes for an HTTP request received by a server. // // The server must be the primary server name if it is known. For example this // would be the ServerName directive // (https://httpd.apache.org/docs/2.4/mod/core.html#servername) for an Apache // server, and the server_name directive // (http://nginx.org/en/docs/http/ngx_http_core_module.html#server_name) for an // nginx server. More generically, the primary server name would be the host // header value that matches the default virtual host of an HTTP server. It // should include the host identifier and if a port is used to route to the // server that port identifier should be included as an appropriate port // suffix. // // If the primary server name is not known, server should be an empty string. // The req Host will be used to determine the server instead. // // The following attributes are always returned: "http.method", "http.scheme", // "http.flavor", "http.target", "net.host.name". The following attributes are // returned if they related values are defined in req: "net.host.port", // "net.sock.peer.addr", "net.sock.peer.port", "http.user_agent", "enduser.id", // "http.client_ip". func (c *HTTPConv) ServerRequest(server string, req *http.Request) []attribute.KeyValue { … } func (c *HTTPConv) method(method string) attribute.KeyValue { … } func (c *HTTPConv) scheme(https bool) attribute.KeyValue { … } func (c *HTTPConv) proto(proto string) attribute.KeyValue { … } func serverClientIP(xForwardedFor string) string { … } func requiredHTTPPort(https bool, port int) int { … } // Return the request host and port from the first non-empty source. func firstHostPort(source ...string) (host string, port int) { … } // RequestHeader returns the contents of h as OpenTelemetry attributes. func (c *HTTPConv) RequestHeader(h http.Header) []attribute.KeyValue { … } // ResponseHeader returns the contents of h as OpenTelemetry attributes. func (c *HTTPConv) ResponseHeader(h http.Header) []attribute.KeyValue { … } func (c *HTTPConv) header(prefix string, h http.Header) []attribute.KeyValue { … } // ClientStatus returns a span status code and message for an HTTP status code // value received by a client. func (c *HTTPConv) ClientStatus(code int) (codes.Code, string) { … } // ServerStatus returns a span status code and message for an HTTP status code // value returned by a server. Status codes in the 400-499 range are not // returned as errors. func (c *HTTPConv) ServerStatus(code int) (codes.Code, string) { … } type codeRange … func (r codeRange) contains(code int) bool { … } var validRangesPerCategory … // validateHTTPStatusCode validates the HTTP status code and returns // corresponding span status code. If the `code` is not a valid HTTP status // code, returns span status Error and false. func validateHTTPStatusCode(code int) (codes.Code, bool) { … }