QuickStat Express.js Plugin

The QuickStat Express.js Plugin provides seamless integration for monitoring REST metrics in Express.js applications. It exports these metrics to Prometheus, enabling visualization in Grafana dashboards.

If you are new to QuickStat and its component, feel free to check the official documentation for a detailed breakdown.

If one of the following frameworks is being used, the dedicated plugins should be used instead of the REST plugin:

• Fastify Plugin
• Koa Plugin
• No dedicated plugin for the framework

Installation

Install the QuickStat core package, the Prometheus data source, and the Express.js plugin:

npm install @quickstat/core
npm install @quickstat/prometheus
npm install @quickstat/expressjs

Getting Started

If you use Docker and want to get started quickly, check out the docker-setup for a streamlined setup. Once Docker is configured, proceed to Step 3.

For manual setup or if you are unfamiliar with QuickStat's plugins, follow these steps:

1. Setup Prometheus and Grafana

1. Install Prometheus: Follow the official documentation to install Prometheus.
2. Install Grafana: Refer to the official documentation for Grafana installation.
3. Configure Prometheus Data Source in Grafana: After installing Grafana, add Prometheus as a data source by specifying its URL.

2. Import Dashboard to Grafana

Add the dashboard to Grafana by navigating to the dashboard page, clicking "Import" and pasting the dashboard template URL. Customize the dashboard based on your needs.

3. Expose Express Metrics

To expose metrics to Prometheus using the QuickStat Express.js Plugin, use the following code snippet:

import express from 'express'
import { Client as QuickStatClient } from '@quickstat/core'
import { ExpressPlugin } from '@quickstat/expressjs'
import { PrometheusDataSource, ScrapeStrategy } from '@quickstat/prometheus'
import http from 'http'

const app = express()

// Create QuickStat Client
const quickStatClient = new QuickStatClient<PrometheusDataSource<ScrapeStrategy>>({
  metrics: [],
  plugins: [
    // Register Express Plugin
    new ExpressPlugin({ app }),
  ],
  // Register the data source
  dataSource: new PrometheusDataSource({
    strategy: new ScrapeStrategy(),
  }),
})

// Express.js Routes Handling
app.put('/users/:id', (req, res) => {
  res.status(204).send('User updated')
})

app.listen(3034, () => console.log('Server started at http://localhost:3034'))

// Let Prometheus scrape the metrics at http://localhost:3242
// WARNING: On production, properly secure the endpoint (if open)
http.createServer(async (req, res) => {
  const response = await quickStatClient.dataSource?.strategy?.getResponse()

  // Write the prometheus response file
  if (response) {
    res.writeHead(200, response.headers)
    res.end(response.file)
  }
}).listen(3242)

4. Start the Application

After setting up the code, start the application. The metrics will be available at http://localhost:3242 in Prometheus format and will be scraped by Prometheus, which will then be used for visualization in Grafana.

Configuration

DataSource

The example uses the PrometheusDataSource with the ScrapeStrategy. This strategy exposes the Prometheus file on a specified endpoint for scraping by Prometheus. Alternatively, use the PushGatewayStrategy to push metrics to the Prometheus PushGateway.

For other data sources, refer to the available options in the @quickstat/core package.

Plugin Options

| Option | Description | Default | | -------------- | --------------------------- | -------- | | app | Express.js application | required | | excludeMetrics | Array of metrics to exclude | [] |

Contributing and Issues

For issues or feature requests, feel free to open an issue on the GitHub repository.