Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Knowledge graphbreadcrumb arrow Configurebreadcrumb arrow Logs correlation (deprecated)
Grafana Cloud

Configure logs correlation

Note

This page describes the previous version of logs correlation configuration. For the current version with flexible property matching and priority-based selection, refer to Configure telemetry correlation.

The following video shows you how to create a custom mapping configuration to correlate logs using the previous version of logs correlation configuration:

The knowledge graph now uses a unified telemetry correlation system for logs, traces, and profiles. This provides:

  • Flexible property matching - Match entities based on any property with multiple operations (equals, contains, is null)
  • Priority-based configuration - Create multiple configurations and control which applies first
  • Entity type filtering - Restrict configurations to specific entity types
  • Consistent approach - Same configuration pattern for logs, traces, and profiles

Migrate to the new configuration

The new telemetry correlation system replaces the Environment and Site fields with flexible property matchers. To migrate your existing configurations:

  1. Navigate to Observability > Configuration > Logs.
  2. Review your existing configurations.
  3. For each configuration:
    • Note the Environment and Site values
    • Create equivalent property matchers:
      • If Environment was prod, add matcher: asserts_env equals ["prod"]
      • If Site was us-east-1, add matcher: asserts_site equals ["us-east-1"]
    • Verify entity property to log label mappings remain correct
  4. Test the updated configuration on representative entities.

Your existing default configuration automatically migrated to the new system.

Next steps

For complete documentation on the current configuration system, refer to:

Manage log configurations using Terraform

You can also manage log configurations using Terraform for infrastructure as code workflows. This enables version control, automated deployments, and consistent log correlation across environments.

For information about managing log configurations with Terraform, refer to Configure log correlation using Terraform.