Skip to content

Infrastructure Data Fair Usage Limits

Coralogix is introducing fair usage limits for Infrastructure Monitoring to ensure platform stability, predictable performance, and fair access for all customers. These limits apply specifically to Infrastructure Explorer and the data you send to it.

What are the limits?

Here’s a summary of the main Fair Usage Limits:
Limit nameApplies toFair usage limitDescription
infra_monitoring_events_processedEvent ingestion5 million/hourNumber of infrastructure events allowed per hour.
infra_monitoring_event_payloadAttribute sizeMax 256 characters/valueAttribute value length in infrastructure monitoring events.
infra_explorer_active_itemsInfrastructure Explorer100,000 active itemsMaximum items shown in Infra Explorer (nodes, pods, volumes, etc.)
infra_explorer_retention_periodInfrastructure Explorer14 daysHow long historical data is retained.

What do the limits mean?

Each limit is designed to prevent:

  • System overloads due to excessive ingestion
  • Noise from non-critical data
  • Unexpected slowdowns for other customers
  • Inefficient data exploration caused by overly large inventories

They define what is considered fair and reliable use of the system at your current plan level.

What happens when you exceed limits?

Each limit is enforced differently:
When limit is exceededSystem behavior
infra_monitoring_events_processedA circuit breaker is triggered. All incoming events are blocked until the next hour.
infra_explorer_active_itemsNew items over the limit are blocked from appearing in Infra Explorer.
infra_monitoring_event_payloadAttribute values longer than 256 characters are truncated or dropped.
infra_explorer_retention_periodOlder data is automatically deleted after 14 days.

When a limit is crossed, Coralogix also emits a diagnostic log that includes:

{
  "limit_name": "<name of the limit>",
  "environment": "<env>",
  "fair_usage_threshold": "<value defined>",
  "current_value": "<current_value_that_breached>",
  "timestamp": "<RFC 3339>",
  "labels": <additional_key_values_for_any_sub_division>
}

Example:

{
"limit_name": "infra_monitoring_events_processed",
"environment": "eu-west-1",
"fair_usage_limit": "5000000",
"current_value": "5000001",
"timestamp": "2025-07-22T14:30:00Z",
"dimensions": {}
}

logs view

These logs appear in your log ingestion pipeline so you can track violations and remediate proactively.


Query Examples

Run this to see all categories of violation logs

query:

source system/labs.limitViolations

query logs view


event: infra_monitoring_events_processed

query:

source system/labs.limitViolations | filter $d.limit_name ~ 'infra_monitoring_events_processed'

event: infra_explorer_active_items

query:

source system/labs.limitViolations | filter $d.limit_name ~ 'infra_explorer_active_items'

query logs view


event: infra_monitoring_event_payload

query:

source system/labs.limitViolations | filter $d.limit_name ~ 'infra_monitoring_event_payload'

event: infra_explorer_retention_period

query:

source system/labs.limitViolations | filter $d.limit_name ~ 'infra_explorer_retention_period'

Where can I view my current usage?

Your current Infrastructure Monitoring usage is visible in the Usage tab of the Coralogix app. Navigate to Settings > Data Usage > Infrastructure data
SectionDescription
Total EventsCumulative number of infrastructure events sent in the selected time window.
Daily MaxThe peak number of events on a single day during the selected period.
StackedDaily breakdown of:• Infrastructure events (light orange)• Blocked infrastructure events (dark orange)• Quota line for reference
Breakdown TableShows daily usage broken down by:• Infrastructure events: All ingested events• Blocked infrastructure events: Dropped or rejected eventsEach day shows the event count and unit usage

Can I control or block data myself?

Yes. You can configure the OpenTelemetry Collector to filter or drop unnecessary infrastructure events before they reach Coralogix. For more information, see Advanced Configurations.

For example:

filterStatements:
  - 'body["metadata"]["namespace"] != "kube-system"'
  - 'body["kind"] != "Event"'

This reduces usage and ensures only important data appears in your infrastructure dashboard.