Envoy service monitoring
Envoy services is a collective name of the Envoy and License server SpeechKit Hybrid components For more information about the SpeechKit Hybrid components, see SpeechKit Hybrid architecture.
Envoy services collect and store metrics in Prometheus format. For more information about metric types, see this Prometheus guide.
License server metrics
License server metrics are available at the URL:
<IP_address>:<port>
Where:
<IP address>: IP address of the License server SpeechKit Hybrid component in your network.<port>: Prometheus port. The default port is8003. You can change it in the SpeechKit Hybrid settings.
Common metrics
| Metric | Type | Description | Labels |
|---|---|---|---|
active_services |
GAUGE | Number of running SpeechKit Hybrid services | type: Service type, stt / tts. |
log4j2_appender_total |
COUNTER | Number of logs with this level. | level: Logging level. |
grpc_statuses |
COUNTER | gRPC method operating states | app (application), method (gRPC method), status (query status). To monitor the link with Yandex Billing, specify the yandex.cloud.ds.billing.BillingService/Register and yandex.cloud.ds.billing.BillingService/SendBillingData values in the method label. |
grpc_durations |
HISTOGRAM | Histogram of the gRPC query processing time | app (application), method (gRPC method), status (query status). |
grpc_requests |
GAUGE | Various metrics of gRPC queries | app (application), method (gRPC method), status (query status). |
Metrics for the Cloud Billing license model
| Metric | Type | Description | Labels |
|---|---|---|---|
billing_agent_billing_units_sent |
COUNTER | Count of billing packets sent to Yandex Billing | unit_type: Service type, stt / tts. |
billing_agent_requests_sent |
COUNTER | Number of queries sent to the Cloud Billing server SpeechKit Hybrid | |
billing_agent_entries_sent |
COUNTER | Number of billing records sent | |
billing_agent_queue_size |
GAUGE | Current Cloud Billing queue size SpeechKit Hybrid | |
billing_agent_billing_units_received |
COUNTER | Number of billing packets received from the stt/tts services. |
unit_type: Service type, stt / tts. |
billing_agent_last_entry_serial |
GAUGE | Serial number of the last billing record sent | |
billing_agent_last_entry_unixtime |
GAUGE | Standard Unix time of the last billing record sent |
Metrics for the Yubikey license model
| Metric | Type | Description | Labels |
|---|---|---|---|
license_active |
GAUGE | License status (0 for inactive license, 1 for active one). |
|
license_parameters |
GAUGE | License options | type, parameter type. max_stt_connections: Maximum number of connections to stt; max_tts_rps: Maximum RPS for tts. |
Envoy metrics
To get information about the Envoy service status, use the administrative interface at the URL:
<IP_address>:9091
Where:
<IP address>: IP address of the Envoy SpeechKit Hybrid service in your network.
For more information about the interface, see this Envoy guide.
Envoy metrics in Prometheus format are available via the administrative interface at the URL:
<IP_address>:9091/stats/prometheus
Note
To get only significant metrics that changed at least once, use this URL: <IP address>:9091/stats?format=prometheus&usedonly.
Informative Envoy metrics for SpeechKit Hybrid monitoring:
-
Upstream metrics for Envoy communications with the
stt/ttsservice clusters. -
Downstream metrics for Envoy communications with external resources. For example:
Metric Type Description Labels downstream_cx_totalCOUNTER Number of HTTP connections during the service operation envoy_http_conn_manager_prefixdownstream_cx_activeGAUGE Number of active HTTP connections. envoy_cluster_name: Cluster name:upstream_stt,upstream_ttsfor SpeechKit Hybrid services.downstream_cx_rx_bytes_totalCOUNTER Amount of information received (in bytes) during the service operation envoy_http_conn_manager_prefixdownstream_cx_tx_bytes_totalCOUNTER Amount of information sent (in bytes) during the service operation envoy_http_conn_manager_prefixdownstream_rq_totalCOUNTER Numbers of queries sent during the service operation envoy_http_conn_manager_prefixdownstream_rq_activeGAUGE Number of active queries. envoy_http_conn_manager_prefix