mirror of https://github.com/istio/istio.io.git
260 lines
7.1 KiB
HTML
260 lines
7.1 KiB
HTML
---
|
|
WARNING: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT. PLEASE MODIFY THE ORIGINAL SOURCE IN THE 'https://github.com/istio/proxy' REPO
|
|
source_repo: https://github.com/istio/proxy
|
|
title: Stats Config
|
|
description: Configuration for Stats Filter.
|
|
location: https://istio.io/docs/reference/config/proxy_extensions/stats.html
|
|
layout: protoc-gen-docs
|
|
generator: protoc-gen-docs
|
|
weight: 20
|
|
number_of_entries: 5
|
|
---
|
|
<h2 id="MetricConfig">MetricConfig</h2>
|
|
<section>
|
|
<p>Metric instance configuration overrides.
|
|
The metric value and the metric type are optional and permit changing the
|
|
reported value for an existing metric.
|
|
The standard metrics are optimized and reported through a “fast-path”.
|
|
The customizations allow full configurability, at the cost of a “slower”
|
|
path.</p>
|
|
|
|
<table class="message-fields">
|
|
<thead>
|
|
<tr>
|
|
<th>Field</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="MetricConfig-dimensions">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricConfig-dimensions">dimensions</a></code></div>
|
|
<div class="type">map<string, string></div>
|
|
</div></td>
|
|
<td>
|
|
<p>(Optional) Collection of tag names and tag expressions to include in the
|
|
metric. Conflicts are resolved by the tag name by overriding previously
|
|
supplied values.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricConfig-name">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricConfig-name">name</a></code></div>
|
|
<div class="type">string</div>
|
|
</div></td>
|
|
<td>
|
|
<p>(Optional) Metric name to restrict the override to a metric. If not
|
|
specified, applies to all.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricConfig-tags_to_remove">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricConfig-tags_to_remove">tags_to_remove</a></code></div>
|
|
<div class="type">string[]</div>
|
|
</div></td>
|
|
<td>
|
|
<p>(Optional) A list of tags to remove.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricConfig-match">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricConfig-match">match</a></code></div>
|
|
<div class="type">string</div>
|
|
</div></td>
|
|
<td>
|
|
<p>NOT IMPLEMENTED. (Optional) Conditional enabling the override.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricConfig-drop">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricConfig-drop">drop</a></code></div>
|
|
<div class="type">bool</div>
|
|
</div></td>
|
|
<td>
|
|
<p>(Optional) If this is set to true, the metric(s) selected by this
|
|
configuration will not be generated or reported.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
<h2 id="MetricDefinition">MetricDefinition</h2>
|
|
<section>
|
|
<table class="message-fields">
|
|
<thead>
|
|
<tr>
|
|
<th>Field</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="MetricDefinition-name">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricDefinition-name">name</a></code></div>
|
|
<div class="type">string</div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric name.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricDefinition-value">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricDefinition-value">value</a></code></div>
|
|
<div class="type">string</div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric value expression.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricDefinition-type">
|
|
<td><div class="field"><div class="name"><code><a href="#MetricDefinition-type">type</a></code></div>
|
|
<div class="type"><a href="#MetricType">MetricType</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric type.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
<h2 id="PluginConfig">PluginConfig</h2>
|
|
<section>
|
|
<table class="message-fields">
|
|
<thead>
|
|
<tr>
|
|
<th>Field</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="PluginConfig-disable_host_header_fallback">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-disable_host_header_fallback">disable_host_header_fallback</a></code></div>
|
|
<div class="type">bool</div>
|
|
</div></td>
|
|
<td>
|
|
<p>Disable using host header as a fallback if destination service is
|
|
not available from the controlplane. Disable the fallback if the host
|
|
header originates outsides the mesh, like at ingress.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-tcp_reporting_duration">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-tcp_reporting_duration">tcp_reporting_duration</a></code></div>
|
|
<div class="type"><a href="https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration">Duration</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Allows configuration of the time between calls out to for TCP
|
|
metrics reporting. The default duration is <code>5s</code>.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-metrics">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-metrics">metrics</a></code></div>
|
|
<div class="type"><a href="#MetricConfig">MetricConfig[]</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric overrides.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-definitions">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-definitions">definitions</a></code></div>
|
|
<div class="type"><a href="#MetricDefinition">MetricDefinition[]</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric definitions.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-reporter">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-reporter">reporter</a></code></div>
|
|
<div class="type"><a href="#Reporter">Reporter</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Proxy deployment type.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-rotation_interval">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-rotation_interval">rotation_interval</a></code></div>
|
|
<div class="type"><a href="https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration">Duration</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric scope rotation interval. Set to 0 to disable the metric scope rotation.
|
|
Defaults to 0.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="PluginConfig-graceful_deletion_interval">
|
|
<td><div class="field"><div class="name"><code><a href="#PluginConfig-graceful_deletion_interval">graceful_deletion_interval</a></code></div>
|
|
<div class="type"><a href="https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration">Duration</a></div>
|
|
</div></td>
|
|
<td>
|
|
<p>Metric expiry graceful deletion interval. No-op if the metric rotation is disabled.
|
|
Defaults to 5m. Must be >=1s.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
<h2 id="MetricType">MetricType</h2>
|
|
<section>
|
|
<table class="enum-values">
|
|
<thead>
|
|
<tr>
|
|
<th>Name</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="MetricType-COUNTER">
|
|
<td><code><a href="#MetricType-COUNTER">COUNTER</a></code></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricType-GAUGE">
|
|
<td><code><a href="#MetricType-GAUGE">GAUGE</a></code></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
<tr id="MetricType-HISTOGRAM">
|
|
<td><code><a href="#MetricType-HISTOGRAM">HISTOGRAM</a></code></td>
|
|
<td>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|
|
<h2 id="Reporter">Reporter</h2>
|
|
<section>
|
|
<p>Specifies the proxy deployment type.</p>
|
|
|
|
<table class="enum-values">
|
|
<thead>
|
|
<tr>
|
|
<th>Name</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="Reporter-UNSPECIFIED">
|
|
<td><code><a href="#Reporter-UNSPECIFIED">UNSPECIFIED</a></code></td>
|
|
<td>
|
|
<p>Default value is inferred from the listener direction, as either client or
|
|
server sidecar.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr id="Reporter-SERVER_GATEWAY">
|
|
<td><code><a href="#Reporter-SERVER_GATEWAY">SERVER_GATEWAY</a></code></td>
|
|
<td>
|
|
<p>Shared server gateway, e.g. “waypoint”.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|