For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/byoc-logs/install.md. A documentation index is available at /llms.txt.

Install BYOC Logs

Join the Preview!

BYOC Logs is in Preview.

Overview

BYOC Logs requires Kubernetes for production deployments. It is supported on cloud-managed Kubernetes services (EKS, GKE, AKS) and self-managed Kubernetes clusters. A Docker installation is also available for local evaluation and testing only.

Docker is for evaluation only. The Docker installation method is designed for exploring BYOC Logs features locally. For production workloads, deploy on a supported Kubernetes platform.

Prerequisites

If you don't see the BYOC Logs entry in the Logs menu, contact your Datadog account team to activate BYOC Logs on your account.

Kubernetes cluster requirements

RequirementDetails
Kubernetes Version1.25 or higher
Supported Platforms- AWS EKS
- Google GKE
- Azure AKS
- Self-managed Kubernetes (Nginx controller)

OpenShift and OCI (Oracle Cloud) are not currently tested or supported.
Metadata StoragePostgreSQL database
Recommended PostgreSQL Options- AWS: RDS PostgreSQL
- GCP: Cloud SQL for PostgreSQL
- Azure: Azure Database for PostgreSQL
- Self-hosted: PostgreSQL with persistent storage

Object storage

BYOC Logs supports the following object storage types:

  • Amazon S3
  • Google Cloud Storage (GCS)
  • Azure Blob Storage
  • MinIO
  • Ceph Object Storage
  • Any S3-compatible storage

Cloud-managed Kubernetes

Select the installation guide that matches your environment: