Raw metric descriptions

Once you receive your app’s raw metrics export, you can build queries to visualize the metrics in tools like Datadog or New Relic. Raw metrics power the Operational Dashboards. They provide granular, real‑time operational data.

Use raw metrics to monitor traffic spikes, troubleshoot errors, and optimize message routing.

Use this glossary to understand what each metric means and which PubNub APIs it refers to.

• pubnub.http_status - Primary metric. Contains most tags listed on this page.

  • Purpose: Track HTTP response patterns across PubNub APIs.
  • Data type: Categorical with numeric status codes.

• customer - Customer account name for a specific subscribe key.

• api - API that handled the request.

  • auth-grant - Authorization grant call (Access Manager v2)
  • channel-registration - Channel group registration
  • files.publish-file - File Sharing API publish call
  • history - History API
  • message-actions - Message Actions API
  • pam-grant - Authorization grant call (Access Manager v3 POST)
  • presence - Presence API
  • publish - Publish API
  • run_after - Functions that run asynchronously after a publish call
  • run_before - Functions that run synchronously (blocking) before a publish call
  • signal - Signal API
  • subscribe - Subscribe API

• status - HTTP response status code from the API call.

  • 200 - OK
  • 403 - Not authorized
  • 404 - Not found (common when querying for a run_after call)
  • 499 - Client disconnected before the completed return

• status_class - Class of the HTTP status code.

  • 2xx - Success
  • 3xx - Redirection
  • 4xx - Client error
  • 5xx - Server error

• region - Cloud region where PubNub recorded the metric (provider nomenclature).

  • us-east-1 - Virginia region
  • us-west-1 - California region
  • eu-central-1 - Frankfurt region
  • ap-northeast-1 - Tokyo region
  • ap-south-1 - Mumbai region