vendor/go.opencensus.io/plugin/ochttp/stats.go - cloudstack-kubernetes-provider - Git at Google

 // Copyright 2018, OpenCensus Authors
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.

 package ochttp

 import (
 	"go.opencensus.io/stats"
 	"go.opencensus.io/stats/view"
 	"go.opencensus.io/tag"
 )

 // The following client HTTP measures are supported for use in custom views.
 var (
 	// Deprecated: Use a Count aggregation over one of the other client measures to achieve the same effect.
 	ClientRequestCount = stats.Int64("opencensus.io/http/client/request_count", "Number of HTTP requests started", stats.UnitDimensionless)
 	// Deprecated: Use ClientSentBytes.
 	ClientRequestBytes = stats.Int64("opencensus.io/http/client/request_bytes", "HTTP request body size if set as ContentLength (uncompressed)", stats.UnitBytes)
 	// Deprecated: Use ClientReceivedBytes.
 	ClientResponseBytes = stats.Int64("opencensus.io/http/client/response_bytes", "HTTP response body size (uncompressed)", stats.UnitBytes)
 	// Deprecated: Use ClientRoundtripLatency.
 	ClientLatency = stats.Float64("opencensus.io/http/client/latency", "End-to-end latency", stats.UnitMilliseconds)
 )

 // Client measures supported for use in custom views.
 var (
 	ClientSentBytes = stats.Int64(
 		"opencensus.io/http/client/sent_bytes",
 		"Total bytes sent in request body (not including headers)",
 		stats.UnitBytes,
 	)
 	ClientReceivedBytes = stats.Int64(
 		"opencensus.io/http/client/received_bytes",
 		"Total bytes received in response bodies (not including headers but including error responses with bodies)",
 		stats.UnitBytes,
 	)
 	ClientRoundtripLatency = stats.Float64(
 		"opencensus.io/http/client/roundtrip_latency",
 		"Time between first byte of request headers sent to last byte of response received, or terminal error",
 		stats.UnitMilliseconds,
 	)
 )

 // The following server HTTP measures are supported for use in custom views:
 var (
 	ServerRequestCount  = stats.Int64("opencensus.io/http/server/request_count", "Number of HTTP requests started", stats.UnitDimensionless)
 	ServerRequestBytes  = stats.Int64("opencensus.io/http/server/request_bytes", "HTTP request body size if set as ContentLength (uncompressed)", stats.UnitBytes)
 	ServerResponseBytes = stats.Int64("opencensus.io/http/server/response_bytes", "HTTP response body size (uncompressed)", stats.UnitBytes)
 	ServerLatency       = stats.Float64("opencensus.io/http/server/latency", "End-to-end latency", stats.UnitMilliseconds)
 )

 // The following tags are applied to stats recorded by this package. Host, Path
 // and Method are applied to all measures. StatusCode is not applied to
 // ClientRequestCount or ServerRequestCount, since it is recorded before the status is known.
 var (
 	// Host is the value of the HTTP Host header.
 	//
 	// The value of this tag can be controlled by the HTTP client, so you need
 	// to watch out for potentially generating high-cardinality labels in your
 	// metrics backend if you use this tag in views.
 	Host, _ = tag.NewKey("http.host")

 	// StatusCode is the numeric HTTP response status code,
 	// or "error" if a transport error occurred and no status code was read.
 	StatusCode, _ = tag.NewKey("http.status")

 	// Path is the URL path (not including query string) in the request.
 	//
 	// The value of this tag can be controlled by the HTTP client, so you need
 	// to watch out for potentially generating high-cardinality labels in your
 	// metrics backend if you use this tag in views.
 	Path, _ = tag.NewKey("http.path")

 	// Method is the HTTP method of the request, capitalized (GET, POST, etc.).
 	Method, _ = tag.NewKey("http.method")

 	// KeyServerRoute is a low cardinality string representing the logical
 	// handler of the request. This is usually the pattern registered on the a
 	// ServeMux (or similar string).
 	KeyServerRoute, _ = tag.NewKey("http_server_route")
 )

 // Client tag keys.
 var (
 	// KeyClientMethod is the HTTP method, capitalized (i.e. GET, POST, PUT, DELETE, etc.).
 	KeyClientMethod, _ = tag.NewKey("http_client_method")
 	// KeyClientPath is the URL path (not including query string).
 	KeyClientPath, _ = tag.NewKey("http_client_path")
 	// KeyClientStatus is the HTTP status code as an integer (e.g. 200, 404, 500.), or "error" if no response status line was received.
 	KeyClientStatus, _ = tag.NewKey("http_client_status")
 	// KeyClientHost is the value of the request Host header.
 	KeyClientHost, _ = tag.NewKey("http_client_host")
 )

 // Default distributions used by views in this package.
 var (
 	DefaultSizeDistribution    = view.Distribution(0, 1024, 2048, 4096, 16384, 65536, 262144, 1048576, 4194304, 16777216, 67108864, 268435456, 1073741824, 4294967296)
 	DefaultLatencyDistribution = view.Distribution(0, 1, 2, 3, 4, 5, 6, 8, 10, 13, 16, 20, 25, 30, 40, 50, 65, 80, 100, 130, 160, 200, 250, 300, 400, 500, 650, 800, 1000, 2000, 5000, 10000, 20000, 50000, 100000)
 )

 // Package ochttp provides some convenience views.
 // You still need to register these views for data to actually be collected.
 var (
 	ClientSentBytesDistribution = &view.View{
 		Name:        "opencensus.io/http/client/sent_bytes",
 		Measure:     ClientSentBytes,
 		Aggregation: DefaultSizeDistribution,
 		Description: "Total bytes sent in request body (not including headers), by HTTP method and response status",
 		TagKeys:     []tag.Key{KeyClientMethod, KeyClientStatus},
 	}

 	ClientReceivedBytesDistribution = &view.View{
 		Name:        "opencensus.io/http/client/received_bytes",
 		Measure:     ClientReceivedBytes,
 		Aggregation: DefaultSizeDistribution,
 		Description: "Total bytes received in response bodies (not including headers but including error responses with bodies), by HTTP method and response status",
 		TagKeys:     []tag.Key{KeyClientMethod, KeyClientStatus},
 	}

 	ClientRoundtripLatencyDistribution = &view.View{
 		Name:        "opencensus.io/http/client/roundtrip_latency",
 		Measure:     ClientRoundtripLatency,
 		Aggregation: DefaultLatencyDistribution,
 		Description: "End-to-end latency, by HTTP method and response status",
 		TagKeys:     []tag.Key{KeyClientMethod, KeyClientStatus},
 	}

 	ClientCompletedCount = &view.View{
 		Name:        "opencensus.io/http/client/completed_count",
 		Measure:     ClientRoundtripLatency,
 		Aggregation: view.Count(),
 		Description: "Count of completed requests, by HTTP method and response status",
 		TagKeys:     []tag.Key{KeyClientMethod, KeyClientStatus},
 	}
 )

 var (
 	// Deprecated: No direct replacement, but see ClientCompletedCount.
 	ClientRequestCountView = &view.View{
 		Name:        "opencensus.io/http/client/request_count",
 		Description: "Count of HTTP requests started",
 		Measure:     ClientRequestCount,
 		Aggregation: view.Count(),
 	}

 	// Deprecated: Use ClientSentBytesDistribution.
 	ClientRequestBytesView = &view.View{
 		Name:        "opencensus.io/http/client/request_bytes",
 		Description: "Size distribution of HTTP request body",
 		Measure:     ClientSentBytes,
 		Aggregation: DefaultSizeDistribution,
 	}

 	// Deprecated: Use ClientReceivedBytesDistribution.
 	ClientResponseBytesView = &view.View{
 		Name:        "opencensus.io/http/client/response_bytes",
 		Description: "Size distribution of HTTP response body",
 		Measure:     ClientReceivedBytes,
 		Aggregation: DefaultSizeDistribution,
 	}

 	// Deprecated: Use ClientRoundtripLatencyDistribution.
 	ClientLatencyView = &view.View{
 		Name:        "opencensus.io/http/client/latency",
 		Description: "Latency distribution of HTTP requests",
 		Measure:     ClientRoundtripLatency,
 		Aggregation: DefaultLatencyDistribution,
 	}

 	// Deprecated: Use ClientCompletedCount.
 	ClientRequestCountByMethod = &view.View{
 		Name:        "opencensus.io/http/client/request_count_by_method",
 		Description: "Client request count by HTTP method",
 		TagKeys:     []tag.Key{Method},
 		Measure:     ClientSentBytes,
 		Aggregation: view.Count(),
 	}

 	// Deprecated: Use ClientCompletedCount.
 	ClientResponseCountByStatusCode = &view.View{
 		Name:        "opencensus.io/http/client/response_count_by_status_code",
 		Description: "Client response count by status code",
 		TagKeys:     []tag.Key{StatusCode},
 		Measure:     ClientRoundtripLatency,
 		Aggregation: view.Count(),
 	}
 )

 var (
 	ServerRequestCountView = &view.View{
 		Name:        "opencensus.io/http/server/request_count",
 		Description: "Count of HTTP requests started",
 		Measure:     ServerRequestCount,
 		Aggregation: view.Count(),
 	}

 	ServerRequestBytesView = &view.View{
 		Name:        "opencensus.io/http/server/request_bytes",
 		Description: "Size distribution of HTTP request body",
 		Measure:     ServerRequestBytes,
 		Aggregation: DefaultSizeDistribution,
 	}

 	ServerResponseBytesView = &view.View{
 		Name:        "opencensus.io/http/server/response_bytes",
 		Description: "Size distribution of HTTP response body",
 		Measure:     ServerResponseBytes,
 		Aggregation: DefaultSizeDistribution,
 	}

 	ServerLatencyView = &view.View{
 		Name:        "opencensus.io/http/server/latency",
 		Description: "Latency distribution of HTTP requests",
 		Measure:     ServerLatency,
 		Aggregation: DefaultLatencyDistribution,
 	}

 	ServerRequestCountByMethod = &view.View{
 		Name:        "opencensus.io/http/server/request_count_by_method",
 		Description: "Server request count by HTTP method",
 		TagKeys:     []tag.Key{Method},
 		Measure:     ServerRequestCount,
 		Aggregation: view.Count(),
 	}

 	ServerResponseCountByStatusCode = &view.View{
 		Name:        "opencensus.io/http/server/response_count_by_status_code",
 		Description: "Server response count by status code",
 		TagKeys:     []tag.Key{StatusCode},
 		Measure:     ServerLatency,
 		Aggregation: view.Count(),
 	}
 )

 // DefaultClientViews are the default client views provided by this package.
 // Deprecated: No replacement. Register the views you would like individually.
 var DefaultClientViews = []*view.View{
 	ClientRequestCountView,
 	ClientRequestBytesView,
 	ClientResponseBytesView,
 	ClientLatencyView,
 	ClientRequestCountByMethod,
 	ClientResponseCountByStatusCode,
 }

 // DefaultServerViews are the default server views provided by this package.
 // Deprecated: No replacement. Register the views you would like individually.
 var DefaultServerViews = []*view.View{
 	ServerRequestCountView,
 	ServerRequestBytesView,
 	ServerResponseBytesView,
 	ServerLatencyView,
 	ServerRequestCountByMethod,
 	ServerResponseCountByStatusCode,
 }
	// Copyright 2018, OpenCensus Authors
	//
	// Licensed under the Apache License, Version 2.0 (the "License");
	// you may not use this file except in compliance with the License.
	// You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing, software
	// distributed under the License is distributed on an "AS IS" BASIS,
	// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	// See the License for the specific language governing permissions and
	// limitations under the License.

	package ochttp

	import (
	"go.opencensus.io/stats"
	"go.opencensus.io/stats/view"
	"go.opencensus.io/tag"
	)

	// The following client HTTP measures are supported for use in custom views.
	var (
	// Deprecated: Use a Count aggregation over one of the other client measures to achieve the same effect.
	ClientRequestCount = stats.Int64("opencensus.io/http/client/request_count", "Number of HTTP requests started", stats.UnitDimensionless)
	// Deprecated: Use ClientSentBytes.
	ClientRequestBytes = stats.Int64("opencensus.io/http/client/request_bytes", "HTTP request body size if set as ContentLength (uncompressed)", stats.UnitBytes)
	// Deprecated: Use ClientReceivedBytes.
	ClientResponseBytes = stats.Int64("opencensus.io/http/client/response_bytes", "HTTP response body size (uncompressed)", stats.UnitBytes)
	// Deprecated: Use ClientRoundtripLatency.
	ClientLatency = stats.Float64("opencensus.io/http/client/latency", "End-to-end latency", stats.UnitMilliseconds)
	)

	// Client measures supported for use in custom views.
	var (
	ClientSentBytes = stats.Int64(
	"opencensus.io/http/client/sent_bytes",
	"Total bytes sent in request body (not including headers)",
	stats.UnitBytes,
	)
	ClientReceivedBytes = stats.Int64(
	"opencensus.io/http/client/received_bytes",
	"Total bytes received in response bodies (not including headers but including error responses with bodies)",
	stats.UnitBytes,
	)
	ClientRoundtripLatency = stats.Float64(
	"opencensus.io/http/client/roundtrip_latency",
	"Time between first byte of request headers sent to last byte of response received, or terminal error",
	stats.UnitMilliseconds,
	)
	)

	// The following server HTTP measures are supported for use in custom views:
	var (
	ServerRequestCount = stats.Int64("opencensus.io/http/server/request_count", "Number of HTTP requests started", stats.UnitDimensionless)
	ServerRequestBytes = stats.Int64("opencensus.io/http/server/request_bytes", "HTTP request body size if set as ContentLength (uncompressed)", stats.UnitBytes)
	ServerResponseBytes = stats.Int64("opencensus.io/http/server/response_bytes", "HTTP response body size (uncompressed)", stats.UnitBytes)
	ServerLatency = stats.Float64("opencensus.io/http/server/latency", "End-to-end latency", stats.UnitMilliseconds)
	)

	// The following tags are applied to stats recorded by this package. Host, Path
	// and Method are applied to all measures. StatusCode is not applied to
	// ClientRequestCount or ServerRequestCount, since it is recorded before the status is known.
	var (
	// Host is the value of the HTTP Host header.
	//
	// The value of this tag can be controlled by the HTTP client, so you need
	// to watch out for potentially generating high-cardinality labels in your
	// metrics backend if you use this tag in views.
	Host, _ = tag.NewKey("http.host")

	// StatusCode is the numeric HTTP response status code,
	// or "error" if a transport error occurred and no status code was read.
	StatusCode, _ = tag.NewKey("http.status")

	// Path is the URL path (not including query string) in the request.
	//
	// The value of this tag can be controlled by the HTTP client, so you need
	// to watch out for potentially generating high-cardinality labels in your
	// metrics backend if you use this tag in views.
	Path, _ = tag.NewKey("http.path")

	// Method is the HTTP method of the request, capitalized (GET, POST, etc.).
	Method, _ = tag.NewKey("http.method")

	// KeyServerRoute is a low cardinality string representing the logical
	// handler of the request. This is usually the pattern registered on the a
	// ServeMux (or similar string).
	KeyServerRoute, _ = tag.NewKey("http_server_route")
	)

	// Client tag keys.
	var (
	// KeyClientMethod is the HTTP method, capitalized (i.e. GET, POST, PUT, DELETE, etc.).
	KeyClientMethod, _ = tag.NewKey("http_client_method")
	// KeyClientPath is the URL path (not including query string).
	KeyClientPath, _ = tag.NewKey("http_client_path")
	// KeyClientStatus is the HTTP status code as an integer (e.g. 200, 404, 500.), or "error" if no response status line was received.
	KeyClientStatus, _ = tag.NewKey("http_client_status")
	// KeyClientHost is the value of the request Host header.
	KeyClientHost, _ = tag.NewKey("http_client_host")
	)

	// Default distributions used by views in this package.
	var (
	DefaultSizeDistribution = view.Distribution(0, 1024, 2048, 4096, 16384, 65536, 262144, 1048576, 4194304, 16777216, 67108864, 268435456, 1073741824, 4294967296)
	DefaultLatencyDistribution = view.Distribution(0, 1, 2, 3, 4, 5, 6, 8, 10, 13, 16, 20, 25, 30, 40, 50, 65, 80, 100, 130, 160, 200, 250, 300, 400, 500, 650, 800, 1000, 2000, 5000, 10000, 20000, 50000, 100000)
	)

	// Package ochttp provides some convenience views.
	// You still need to register these views for data to actually be collected.
	var (
	ClientSentBytesDistribution = &view.View{
	Name: "opencensus.io/http/client/sent_bytes",
	Measure: ClientSentBytes,
	Aggregation: DefaultSizeDistribution,
	Description: "Total bytes sent in request body (not including headers), by HTTP method and response status",
	TagKeys: []tag.Key{KeyClientMethod, KeyClientStatus},
	}

	ClientReceivedBytesDistribution = &view.View{
	Name: "opencensus.io/http/client/received_bytes",
	Measure: ClientReceivedBytes,
	Aggregation: DefaultSizeDistribution,
	Description: "Total bytes received in response bodies (not including headers but including error responses with bodies), by HTTP method and response status",
	TagKeys: []tag.Key{KeyClientMethod, KeyClientStatus},
	}

	ClientRoundtripLatencyDistribution = &view.View{
	Name: "opencensus.io/http/client/roundtrip_latency",
	Measure: ClientRoundtripLatency,
	Aggregation: DefaultLatencyDistribution,
	Description: "End-to-end latency, by HTTP method and response status",
	TagKeys: []tag.Key{KeyClientMethod, KeyClientStatus},
	}

	ClientCompletedCount = &view.View{
	Name: "opencensus.io/http/client/completed_count",
	Measure: ClientRoundtripLatency,
	Aggregation: view.Count(),
	Description: "Count of completed requests, by HTTP method and response status",
	TagKeys: []tag.Key{KeyClientMethod, KeyClientStatus},
	}
	)

	var (
	// Deprecated: No direct replacement, but see ClientCompletedCount.
	ClientRequestCountView = &view.View{
	Name: "opencensus.io/http/client/request_count",
	Description: "Count of HTTP requests started",
	Measure: ClientRequestCount,
	Aggregation: view.Count(),
	}

	// Deprecated: Use ClientSentBytesDistribution.
	ClientRequestBytesView = &view.View{
	Name: "opencensus.io/http/client/request_bytes",
	Description: "Size distribution of HTTP request body",
	Measure: ClientSentBytes,
	Aggregation: DefaultSizeDistribution,
	}

	// Deprecated: Use ClientReceivedBytesDistribution.
	ClientResponseBytesView = &view.View{
	Name: "opencensus.io/http/client/response_bytes",
	Description: "Size distribution of HTTP response body",
	Measure: ClientReceivedBytes,
	Aggregation: DefaultSizeDistribution,
	}

	// Deprecated: Use ClientRoundtripLatencyDistribution.
	ClientLatencyView = &view.View{
	Name: "opencensus.io/http/client/latency",
	Description: "Latency distribution of HTTP requests",
	Measure: ClientRoundtripLatency,
	Aggregation: DefaultLatencyDistribution,
	}

	// Deprecated: Use ClientCompletedCount.
	ClientRequestCountByMethod = &view.View{
	Name: "opencensus.io/http/client/request_count_by_method",
	Description: "Client request count by HTTP method",
	TagKeys: []tag.Key{Method},
	Measure: ClientSentBytes,
	Aggregation: view.Count(),
	}

	// Deprecated: Use ClientCompletedCount.
	ClientResponseCountByStatusCode = &view.View{
	Name: "opencensus.io/http/client/response_count_by_status_code",
	Description: "Client response count by status code",
	TagKeys: []tag.Key{StatusCode},
	Measure: ClientRoundtripLatency,
	Aggregation: view.Count(),
	}
	)

	var (
	ServerRequestCountView = &view.View{
	Name: "opencensus.io/http/server/request_count",
	Description: "Count of HTTP requests started",
	Measure: ServerRequestCount,
	Aggregation: view.Count(),
	}

	ServerRequestBytesView = &view.View{
	Name: "opencensus.io/http/server/request_bytes",
	Description: "Size distribution of HTTP request body",
	Measure: ServerRequestBytes,
	Aggregation: DefaultSizeDistribution,
	}

	ServerResponseBytesView = &view.View{
	Name: "opencensus.io/http/server/response_bytes",
	Description: "Size distribution of HTTP response body",
	Measure: ServerResponseBytes,
	Aggregation: DefaultSizeDistribution,
	}

	ServerLatencyView = &view.View{
	Name: "opencensus.io/http/server/latency",
	Description: "Latency distribution of HTTP requests",
	Measure: ServerLatency,
	Aggregation: DefaultLatencyDistribution,
	}

	ServerRequestCountByMethod = &view.View{
	Name: "opencensus.io/http/server/request_count_by_method",
	Description: "Server request count by HTTP method",
	TagKeys: []tag.Key{Method},
	Measure: ServerRequestCount,
	Aggregation: view.Count(),
	}

	ServerResponseCountByStatusCode = &view.View{
	Name: "opencensus.io/http/server/response_count_by_status_code",
	Description: "Server response count by status code",
	TagKeys: []tag.Key{StatusCode},
	Measure: ServerLatency,
	Aggregation: view.Count(),
	}
	)

	// DefaultClientViews are the default client views provided by this package.
	// Deprecated: No replacement. Register the views you would like individually.
	var DefaultClientViews = []*view.View{
	ClientRequestCountView,
	ClientRequestBytesView,
	ClientResponseBytesView,
	ClientLatencyView,
	ClientRequestCountByMethod,
	ClientResponseCountByStatusCode,
	}

	// DefaultServerViews are the default server views provided by this package.
	// Deprecated: No replacement. Register the views you would like individually.
	var DefaultServerViews = []*view.View{
	ServerRequestCountView,
	ServerRequestBytesView,
	ServerResponseBytesView,
	ServerLatencyView,
	ServerRequestCountByMethod,
	ServerResponseCountByStatusCode,
	}