​
Overview

Custom metrics add context to your cloud spend. They power two primary use-cases:
  1. Unit Economics – combine cost with a business KPI (users, API calls, GB processed) to track efficiency trends.
  2. Enhanced Reporting – surface any metric as a column, filter, or chart in standard Pelanor reports and dashboards.

​
Metric Types

TypeDescriptionExampleBest For
Basic MetricsA single count value per timestamp.Total daily active usersOrg-level KPIs (users, requests)
Dimensional MetricsMetric values split by one or more properties.Active users per region per dayDeeper analysis across segments

​
Getting Started

​
Integration Options

1

Open Custom Metrics

Navigate to Unit Cost → Custom Metrics in Pelanor.
2

Review the API Guide

Click API Documentation to view payload schemas and examples.
3

Send Your Data

POST metrics to the /v1/custom-metrics endpoint using the documented format.
Pelanor API Docs
  1. Pelanor can ingest periodic CSVs dropped into a dedicated S3 bucket or uploaded manually.
  2. Contact Support to configure ingestion.
After upload, processing may take a few minutes before metrics become searchable.

​
Accessing Your Metrics

Imported metrics appear in two places:
  1. Reports & Dashboards – add a metric as a column, filter, or chart just like built-in cost metrics.
  2. Unit Cost Dashboard – a purpose-built view that pairs cost with a denominator metric to compute unit costs.

​
Unit Cost Dashboard

Unit Economics Dashboard Screenshot

​
Cost Filters

Refine which costs participate in unit-cost calculations—for example, include only production spend or tag-based subsets.
Cost Filter Settings

​
Using the Dashboard

1

Configure Cost Filters

Select which resources should count toward your calculations.
2

Set Date Range

Choose the analysis window (daily, weekly, monthly).
3

Choose Aggregation

Pick how to roll up data—daily, weekly, or monthly.
  • Current vs. previous period summaries
  • Unit-cost trends
  • Cost-distribution charts
  • Detailed tables
Basic Metrics Dashboard

​
Working with Widgets

1

Add Widget to Dashboard

In any widget menu, click Add to dashboard.
Add Widget
2

Select Destination

Choose which dashboard should host the widget.
Select Dashboard
3

View the Widget

The widget is appended to the destination dashboard automatically.