---
title: Federated Logs
description: >-
  Search logs stored in your own data platform from Log Explorer, without
  ingesting them into Datadog.
breadcrumbs: Docs > Log Management > Log Explorer > Federated Logs
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Federated Logs

{% callout %}
##### Join the Preview!

Federated Logs is in Preview. Use this form to submit your request today.

[Request Access](https://www.datadoghq.com/product-preview/federated-search/)
{% /callout %}

## Overview{% #overview %}

Federated Logs lets you search logs stored in your own data platform, such as Databricks, from [Log Explorer](https://app.datadoghq.com/logs), without ingesting them into Datadog. Datadog translates your Log Explorer query into the query language of the source and runs it against your table. The data stays in your data platform.

Use Federated Logs to investigate logs that you keep in your data platform, such as logs retained for compliance or analytics.

With an external source, you can:

- Search and filter logs with the [Log Explorer search syntax](https://docs.datadoghq.com/logs/explorer/search_syntax.md).
- View results in the list view and in a timeline histogram grouped by status.
- Open a log in the side panel and share a link to it.
- Add or remove columns, and export results to CSV.

## Prerequisites{% #prerequisites %}

- Access to the Federated Logs Preview. To request access, complete the [Preview form](https://www.datadoghq.com/product-preview/federated-search/).
- At least one external source. See [External Sources](https://docs.datadoghq.com/logs/log_configuration/external_sources.md).
- The Logs Federated Query Read (`logs_federated_query_read`) permission, which lets you search external sources in Log Explorer. For more information, see [Role Based Access Control](https://docs.datadoghq.com/account_management/rbac.md).

## Search federated logs{% #search-federated-logs %}

1. Go to [Log Explorer](https://app.datadoghq.com/logs).
1. Click the data source dropdown next to the search bar, which is set to Indexes by default.
1. Under External Sources, select your source type, and then select an external source.
1. Select a time range and enter a query, such as `service:web status:error`.

## Search syntax{% #search-syntax %}

Federated Logs uses the [Log Explorer search syntax](https://docs.datadoghq.com/logs/explorer/search_syntax.md). Each term in your query searches a column of your table:

{% dl %}

{% dt %}
`service:web`
{% /dt %}

{% dd %}
Searches the column mapped to the Datadog field in the [schema mapping](https://docs.datadoghq.com/logs/log_configuration/external_sources.md#schema-mapping). Applies to `host`, `service`, `source`, `status`, `message`, and `_id`.
{% /dd %}

{% dt %}
`@http_status_code:500`
{% /dt %}

{% dd %}
Searches the top-level column with that name. The column does not need to be mapped.
{% /dd %}

{% dt %}
`env:prod`
{% /dt %}

{% dd %}
Searches for the `env:prod` value in your tags column, which is the column you selected for the Tags field in the schema mapping. If you didn't map the Tags field, Datadog searches a column named `tags`. If the table has no `tags` column, the query returns an error.
{% /dd %}

{% /dl %}

To search a column of your table, prefix its name with `@`. A `key:value` term without `@` searches your tags column.

## Limitations{% #limitations %}

- Full-text search, CIDR queries, and filters on nested JSON or STRUCT fields are not supported.
- Wildcards and ranges on tags are not supported.
- Columns that are not mapped to a Datadog field are not displayed as attributes in the side panel.
- Analytics views, such as grouping and timeseries, are not available.

## Further reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Connect an external source](https://docs.datadoghq.com/logs/log_configuration/external_sources.md)
- [Search logs in your archives with Archive Search](https://docs.datadoghq.com/logs/explorer/archive_search.md)
