Blip Docs
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

error.host

The error.host domain includes server error metrics grouped by host from error summary tables.

Usage

For example:

mysql> SELECT * FROM performance_schema.events_errors_summary_by_host_by_error WHERE error_number = 3024 AND HOST IN ('host1')\G
*************************** 1. row ***************************
             HOST: host1
     ERROR_NUMBER: 3024
       ERROR_NAME: ER_QUERY_TIMEOUT
        SQL_STATE: HY000
 SUM_ERROR_RAISED: 1
SUM_ERROR_HANDLED: 0
       FIRST_SEEN: 2025-04-30 16:30:16
        LAST_SEEN: 2025-04-30 16:30:16

The SUM_ERR_RAISED value is used for the Blip raised metric. ERROR_NUMBER, ERROR_NAME, and HOST are used to group the metric.

Derived Metrics

None.

Options

all

ValueDefaultDescription
yesCollect metrics on all errors (not recommended)
noCollect only metrics for the errors listed in the plan
excludeCollect metrics only for errors that are not listed in the plan

total

ValueDefaultDescription
yesReturn the total number of errors raised
noDo not return the total number of errors raised
onlyOnly return the total number of errors raised

If all is not set to yes the total will only reflect those errors that are specifically included or not excluded from collection.

include

Value TypeCSV string of hosts
Default

A comma-separated list of hosts to include. Overrides option exclude.

exclude

Value TypeCSV string of hosts
Default

A comma-separated list of hosts to exclude. Ignored if include is set.

truncate-table

ValueDefaultDescription
yesTruncate table after each successful collection
noDo not truncate table

If the table is truncated (default), the metrics are delta counters. Else, the values are cumulative counters.

truncate-timeout

Value TypeDuration string
Default250ms

Sets @@session.lock_wait_timeout to avoid waiting too long when truncating the table. Normally, truncating a table is nearly instantaneous, but metadata locks can block the operation.

truncate-on-startup

ValueDefaultDescription
yesTruncate source table on start of metric collection
noDo not truncate source table on startup

Truncates the source table when Blip starts. The timeout use will be the same as specified by truncate-timeout.

Group Keys

KeyValue
error_nunmberThe error number or an empty string for a total
error_nameThe short error name or an empty string for a total
error_hostThe host for the error

Meta

None.

Error Policies

NameMySQL Error
truncate-timeoutError truncating table

MySQL Config

See

and related pages in the MySQL manual.

Changelog

Blip VersionChange
TBDDomain added