# @forge/metrics

> Forge internal metrics

Latest version **1.0.10** (published 2026-11-09) · SEE LICENSE IN LICENSE.txt license · 0 weekly downloads

## Install

```sh
npm install @forge/metrics
pnpm add @forge/metrics
yarn add @forge/metrics
bun add @forge/metrics
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.10 |
| Published | 2026-11-09 |
| First published | 2022-11-24 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.txt |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 55 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@forge/metrics
- npm.io page: https://npm.io/package/@forge/metrics

## Dependencies (2)

- [@forge/api](https://npm.io/package/@forge/api.md) 8.5.0
- [@forge/runtime](https://npm.io/package/@forge/runtime.md) 7.0.3

## Recent versions

- 1.0.10 (latest) — 2026-11-09
- 1.0.11-next.3-experimental-ea0dc44 (experimental) — 2026-11-19
- 1.0.11-next.3 (next) — 2026-11-16
- 1.0.11-next.3-experimental-aab0b34 — 2026-11-19
- 1.0.11-next.3-experimental-f59888d — 2026-11-18
- 1.0.11-next.3-experimental-55abb77 — 2026-11-18
- 1.0.11-next.3-experimental-c04e853 — 2026-11-17
- 1.0.11-next.3-experimental-a5f8a43 — 2026-11-16
- 1.0.11-next.2 — 2026-11-12
- 1.0.11-next.1 — 2026-11-11
- 1.0.11-next.0 — 2026-11-11
- 1.0.10-next.4 — 2026-11-05
- 1.0.10-next.3 — 2026-11-04
- 1.0.10-next.1-experimental-1e95696 — 2026-11-01
- 1.0.10-next.2 — 2026-10-29
- … 574 more at https://npm.io/package/@forge/metrics/versions

## README

# Forge custom metrics

See [Forge custom metrics](https://developer.atlassian.com/platform/forge/monitor-custom-metrics/) for details on setup, use and viewing custom metrics instrumented in your forge app on [developer console](https://developer.atlassian.com/console/myapps)

## Requirements

See [Set up Forge](https://developer.atlassian.com/platform/forge/set-up-forge/) for details of the software required to develop Forge apps.

## Usage

In your Forge app, include the following:

```

import { internalMetrics } from '@forge/metrics';

export const run = async (payload, context) => {
+  const counter = internalMetrics.counter('jiraActions'); // Name should exactly match as registered in developer console
+
+  const jiraIssues = fetch(...);
+  
+  for (const issue of jiraIssues) {
+    counter.incr(); // Increment by 1
+    // Or increment by a specific value
+    counter.incrBy(value);
+  }
+};

```

## Support

See [Get help](https://developer.atlassian.com/platform/forge/get-help/) for how to get help and provide feedback.

---
_Source: https://npm.io/package/@forge/metrics · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
