Skip to main content

Hetzner Cloud

Required Hetzner Cloud Attributes​

Cost calculation tags identify your Hetzner Cloud infrastructure and enable accurate cost tracking for distributed traces. Beakpoint uses these attributes to correlate spans with their server instances and calculate proportional costs based on resource utilization.

The following tags are required for traces originating from Hetzner Cloud servers:

Always Required Fields​

These fields are always required for Hetzner Cloud cost calculation:

Attribute NameExample ValueAllowed Values
cloud.platformhetzner_cloudhetzner_cloud
host.id12345678Unique Hetzner server ID (found in Cloud Console)
host.typecpx51Hetzner server type identifier (e.g., cpx11, cpx21, cpx31, cpx41, cpx51)
cloud.regionhel1Hetzner datacenter location (e.g., fsn1, nbg1, hel1, ash)

Cost Calculation​

Hetzner Cloud servers are priced at an hourly rate. Beakpoint calculates the cost per span using:

cost = hourly_rate × (span_duration_seconds / 3600)

Time-Sharing for Overlapping Spans​

When multiple spans execute concurrently on the same server (identified by cloud.platform + host.id + host.type), their costs are proportionally shared. The total server hourly cost is divided among all active spans during each overlapping time window, so each span pays only for its proportional share of execution time.

Spans on different server instances always maintain independent pricing and never share costs.

Example Configuration​

Set these as OpenTelemetry resource attributes in your application:

OTEL_RESOURCE_ATTRIBUTES: "cloud.platform=hetzner_cloud,host.id=12345678,host.type=cpx51,cloud.region=hel1"

Finding Your Values​

  • host.id: Retrieve from the Hetzner Cloud Console or via the API (GET /servers)
  • host.type: Check your server details in the Cloud Console or query the API
  • cloud.region: Corresponds to your server's datacenter location (view in Cloud Console under server details)

These attributes should be set once during application initialization and attached to all telemetry data from that instance.