> This page is for Taurus PROTECT, version v3.46.
> For other versions, use one of these documentation indexes:
> - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt
> - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt
> - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt
> - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt
> - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt
> - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt
> - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt
> - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt
> - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt
> - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt
> - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server.

# Metrics

# Metrics Introduction

Metrics in Taurus' system are provided with **Prometheus**, an open-source monitoring system with a dimensional data model, flexible query language, efficient time series database and modern alerting approach.

**Taurus** mainly uses **Prometheus** to collect and store metrics as time series data. This means that metrics information is stored with the timestamp at which it was recorded, alongside optional key-value pairs called **labels**.

In this page, we will explain the different metric families, with thorough explanations and detailed representations.

# Metrics Family and Description

## Go Metrics

\


| Metric Family                           | Metric Description                                                                                                                                                                                                  |
| :-------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| go\_build\_info                         | Build information about the main Go module.                                                                                                                                                                         |
| go\_gc\_duration\_seconds               | A summary of the wall-time pause (stop-the-world) duration in garbage collection cycles.                                                                                                                            |
| go\_gc\_gogc\_percent                   | Heap size target percentage configured by the user, otherwise 100. This value is set by the GOGC environment variable, and the runtime/debug.SetGCPercent function. Sourced from /gc/gogc:percent                   |
| go\_gc\_gomemlimit\_bytes               | Go runtime memory limit configured by the user, otherwise math.MaxInt64. This value is set by the GOMEMLIMIT environment variable, and the runtime/debug.SetMemoryLimit function. Sourced from /gc/gomemlimit:bytes |
| go\_goroutines                          | Number of goroutines that currently exist.                                                                                                                                                                          |
| go\_info                                | Information about the Go environment.                                                                                                                                                                               |
| go\_memstats\_alloc\_bytes              | Number of bytes allocated in heap and currently in use. Equals to /memory/classes/heap/objects:bytes.                                                                                                               |
| go\_memstats\_alloc\_bytes\_total       | Total number of bytes allocated in heap until now, even if released already. Equals to /gc/heap/allocs:bytes.                                                                                                       |
| go\_memstats\_buck\_hash\_sys\_bytes    | Number of bytes used by the profiling bucket hash table. Equals to /memory/classes/profiling/buckets:bytes.                                                                                                         |
| go\_memstats\_frees\_total              | Total number of heap objects frees. Equals to /gc/heap/frees:objects + /gc/heap/tiny/allocs:objects.                                                                                                                |
| go\_memstats\_gc\_sys\_bytes            | Number of bytes used for garbage collection system metadata. Equals to /memory/classes/metadata/other:bytes.                                                                                                        |
| go\_memstats\_heap\_alloc\_bytes        | Number of heap bytes allocated and currently in use, same as go\_memstats\_alloc\_bytes. Equals to /memory/classes/heap/objects:bytes.                                                                              |
| go\_memstats\_heap\_idle\_bytes         | Number of heap bytes waiting to be used. Equals to /memory/classes/heap/released:bytes + /memory/classes/heap/free:bytes.                                                                                           |
| go\_memstats\_heap\_inuse\_bytes        | Number of heap bytes that are in use. Equals to /memory/classes/heap/objects:bytes + /memory/classes/heap/unused:bytes.                                                                                             |
| go\_memstats\_heap\_objects             | Number of currently allocated objects. Equals to /gc/heap/objects:objects.                                                                                                                                          |
| go\_memstats\_heap\_released\_bytes     | Number of heap bytes released to OS. Equals to /memory/classes/heap/released:bytes.                                                                                                                                 |
| go\_memstats\_heap\_sys\_bytes          | Number of heap bytes obtained from system. Equals to /memory/classes/heap/objects:bytes + /memory/classes/heap/unused:bytes + /memory/classes/heap/released:bytes + /memory/classes/heap/free:bytes.                |
| go\_memstats\_last\_gc\_time\_seconds   | Number of seconds since 1970 of last garbage collection.                                                                                                                                                            |
| go\_memstats\_mallocs\_total            | Total number of heap objects allocated, both live and gc-ed. Semantically a counter version for go\_memstats\_heap\_objects gauge. Equals to /gc/heap/allocs:objects + /gc/heap/tiny/allocs:objects.                |
| go\_memstats\_mcache\_inuse\_bytes      | Number of bytes in use by mcache structures. Equals to /memory/classes/metadata/mcache/inuse:bytes.                                                                                                                 |
| go\_memstats\_mcache\_sys\_bytes        | Number of bytes used for mcache structures obtained from system. Equals to /memory/classes/metadata/mcache/inuse:bytes + /memory/classes/metadata/mcache/free:bytes.                                                |
| go\_memstats\_mspan\_inuse\_bytes       | Number of bytes in use by mspan structures. Equals to /memory/classes/metadata/mspan/inuse:bytes.                                                                                                                   |
| go\_memstats\_mspan\_sys\_bytes         | Number of bytes used for mspan structures obtained from system. Equals to /memory/classes/metadata/mspan/inuse:bytes + /memory/classes/metadata/mspan/free:bytes.                                                   |
| go\_memstats\_next\_gc\_bytes           | Number of heap bytes when next garbage collection will take place. Equals to /gc/heap/goal:bytes.                                                                                                                   |
| go\_memstats\_other\_sys\_bytes         | Number of bytes used for other system allocations. Equals to /memory/classes/other:bytes.                                                                                                                           |
| go\_memstats\_stack\_inuse\_bytes       | Number of bytes obtained from system for stack allocator in non-CGO environments. Equals to /memory/classes/heap/stacks:bytes.                                                                                      |
| go\_memstats\_stack\_sys\_bytes         | Number of bytes obtained from system for stack allocator. Equals to /memory/classes/heap/stacks:bytes + /memory/classes/os-stacks:bytes.                                                                            |
| go\_memstats\_sys\_bytes                | Number of bytes obtained from system. Equals to /memory/classes/total:byte.                                                                                                                                         |
| go\_sched\_gomaxprocs\_threads          | The current runtime.GOMAXPROCS setting, or the number of operating system threads that can execute user-level Go code simultaneously. Sourced from /sched/gomaxprocs:threads.                                       |
| go\_sql\_idle\_connections              | The number of idle connections.                                                                                                                                                                                     |
| go\_sql\_in\_use\_connections           | The number of connections currently in use.                                                                                                                                                                         |
| go\_sql\_max\_idle\_closed\_total       | The total number of connections closed due to SetMaxIdleConns.                                                                                                                                                      |
| go\_sql\_max\_idle\_time\_closed\_total | The total number of connections closed due to SetConnMaxIdleTime.                                                                                                                                                   |
| go\_sql\_max\_lifetime\_closed\_total   | The total number of connections closed due to SetConnMaxLifetime.                                                                                                                                                   |
| go\_sql\_max\_open\_connections         | Maximum number of open connections to the database.                                                                                                                                                                 |
| go\_sql\_open\_connections              | The number of established connections both in use and idle.                                                                                                                                                         |
| go\_sql\_wait\_count\_total             | The total number of connections waited for.                                                                                                                                                                         |
| go\_sql\_wait\_duration\_seconds\_total | The total time blocked waiting for a new connection.                                                                                                                                                                |
| go\_threads                             | Number of OS threads created.                                                                                                                                                                                       |

## GRPC Metrics

| Metric Family                   | Metric Description                                                                                   |
| :------------------------------ | :--------------------------------------------------------------------------------------------------- |
| grpc\_server\_handled\_total    | Total number of RPCs completed on the server, regardless of success or failure.                      |
| grpc\_server\_handling\_seconds | Summary of response latency (seconds) of gRPC that had been application-level handled by the server. |

## Taurus validatord metrics

| Metric Family                                       | Metric Description                                     |
| :-------------------------------------------------- | :----------------------------------------------------- |
| tg\_validatord\_cryptocompareClient\_APICall\_total | Total number of API calls by the cryptocompare client. |
| tg\_validatord\_database\_request\_timing\_seconds  | Time taken by database requests.                       |
| tg\_validatord\_info                                | Info about the particular instance.                    |
| tg\_validatord\_job\_wallet\_elapsed\_time\_ns      | Elapsed time for job wallet operations in nanoseconds. |
| tg\_validatord\_log\_event\_counter                 | Counts the number of log events.                       |
| tg\_validatord\_pq\_error\_counter                  | Total number of database errors from pq.               |

## Taurus Job Metrics

| Metric Family                              | Metric Description                                                               |
| :----------------------------------------- | :------------------------------------------------------------------------------- |
| tg\_job\_job\_execution\_time\_in\_seconds | Summary of job execution time. An observation is created for each job execution. |
| tg\_job\_job\_state                        | State of job: 0=unknown, 1=disabled, 2=enabled.                                  |
| tg\_job\_job\_status\_counters             | Count the status occurrences.                                                    |
| tgJob\_controller\_state                   | State of the controller: 0=unknown, 1=stopped, 2=started.                        |
| tgJob\_info                                | Info about the job library.                                                      |

# Metric Family and representation

| Metric Name                                         | Metric Representation |
| :-------------------------------------------------- | :-------------------- |
| go\_build\_info                                     | gauge                 |
| go\_gc\_duration\_seconds                           | summary               |
| go\_gc\_gogc\_percent                               | gauge                 |
| go\_gc\_gomemlimit\_bytes                           | gauge                 |
| go\_goroutines                                      | gauge                 |
| go\_info                                            | gauge                 |
| go\_memstats\_alloc\_bytes                          | gauge                 |
| go\_memstats\_alloc\_bytes\_total                   | counter               |
| go\_memstats\_buck\_hash\_sys\_bytes                | gauge                 |
| go\_memstats\_frees\_total                          | counter               |
| go\_memstats\_gc\_sys\_bytes                        | gauge                 |
| go\_memstats\_heap\_alloc\_bytes                    | gauge                 |
| go\_memstats\_heap\_idle\_bytes                     | gauge                 |
| go\_memstats\_heap\_inuse\_bytes                    | gauge                 |
| go\_memstats\_heap\_objects                         | gauge                 |
| go\_memstats\_heap\_released\_bytes                 | gauge                 |
| go\_memstats\_heap\_sys\_bytes                      | gauge                 |
| go\_memstats\_last\_gc\_time\_seconds               | gauge                 |
| go\_memstats\_mallocs\_total                        | counter               |
| go\_memstats\_mcache\_inuse\_bytes                  | gauge                 |
| go\_memstats\_mcache\_sys\_bytes                    | gauge                 |
| go\_memstats\_mspan\_inuse\_bytes                   | gauge                 |
| go\_memstats\_mspan\_sys\_bytes                     | gauge                 |
| go\_memstats\_next\_gc\_bytes                       | gauge                 |
| go\_memstats\_other\_sys\_bytes                     | gauge                 |
| go\_memstats\_stack\_inuse\_bytes                   | gauge                 |
| go\_memstats\_stack\_sys\_bytes                     | gauge                 |
| go\_memstats\_sys\_bytes                            | gauge                 |
| go\_sched\_gomaxprocs\_threads                      | gauge                 |
| go\_sql\_idle\_connections                          | gauge                 |
| go\_sql\_in\_use\_connections                       | gauge                 |
| go\_sql\_max\_idle\_closed\_total                   | counter               |
| go\_sql\_max\_idle\_time\_closed\_total             | counter               |
| go\_sql\_max\_lifetime\_closed\_total               | counter               |
| go\_sql\_max\_open\_connections                     | gauge                 |
| go\_sql\_open\_connections                          | gauge                 |
| go\_sql\_wait\_count\_total                         | counter               |
| go\_sql\_wait\_duration\_seconds\_total             | counter               |
| go\_threads                                         | gauge                 |
| grpc\_server\_handled\_total                        | counter               |
| grpc\_server\_handling\_seconds                     | summary               |
| tg\_job\_job\_execution\_time\_in\_seconds          | summary               |
| tg\_job\_job\_state                                 | gauge                 |
| tg\_job\_job\_status\_counters                      | counter               |
| tg\_validatord\_cryptocompareClient\_APICall\_total | counter               |
| tg\_validatord\_database\_request\_timing\_seconds  | summary               |
| tg\_validatord\_info                                | gauge                 |
| tg\_validatord\_job\_wallet\_elapsed\_time\_ns      | gauge                 |
| tg\_validatord\_log\_event\_counter                 | counter               |
| tg\_validatord\_pq\_error\_counter                  | counter               |
| tgJob\_controller\_state                            | gauge                 |
| tgJob\_info                                         | gauge                 |