---
title: "Gauge | Grafana k6 documentation"
description: "Gauge is an object for representing a custom metric holding only the latest value added."
---

# Gauge

*Gauge* is an object for representing a custom metric holding only the latest value added. It’s one of the four [metric types](/docs/k6/latest/javascript-api/k6-metrics/).

Expand table

| Parameter | Type    | Description                                                                                         |
|-----------|---------|-----------------------------------------------------------------------------------------------------|
| `name`    | string  | The name of the custom metric.                                                                      |
| `isTime`  | boolean | A boolean indicating whether the values added to the metric are time values or just untyped values. |

Expand table

| Method                                                                                   | Description                                                                |
|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [Gauge.add(value, \[tags\])](/docs/k6/latest/javascript-api/k6-metrics/gauge/gauge-add/) | Add a value to the gauge metric. Only the latest value added will be kept. |

## Gauge usage in Thresholds

When gauge is used in a threshold expression, the variable must be called `value` (lower case). For example:

- `value < 200`
- `value > 1`

### Examples

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
import { Gauge } from 'k6/metrics';

const myGauge = new Gauge('my_gauge');

export default function () {
  myGauge.add(3);
  myGauge.add(1);
  myGauge.add(2, { tag1: 'value', tag2: 'value2' });
}
```

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
import http from 'k6/http';
import { sleep } from 'k6';
import { Gauge } from 'k6/metrics';

const GaugeContentSize = new Gauge('ContentSize');

export const options = {
  thresholds: {
    ContentSize: ['value<4000'],
  },
};

export default function () {
  const res = http.get('https://quickpizza.grafana.com');
  GaugeContentSize.add(res.body.length);
  sleep(1);
}
```