---
title: "Gauge.add(value, [tags]) | Grafana k6 documentation"
description: "Set the value of the Gauge metric."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Gauge.add(value, \[tags])

Set the value of the `Gauge` metric.

Expand table

| Parameter | Type   | Description                                                                                                                                                                   |
|-----------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| value     | number | The value to set the gauge to.                                                                                                                                                |
| tags      | object | Set of [tags](/docs/k6/latest/using-k6/tags-and-groups/) that will be tagged to the added data point (note that tags are added per data point and not for the entire metric). |

[Gauge examples](/docs/k6/latest/javascript-api/k6-metrics/gauge/#examples)