Learn About Connected Environments
If you have one or more on-prem Cribl Edge environments and Cribl.Cloud Organization(s), you can configure Connected Environments.
Connected Environments enables you to:
Use Cribl.Cloud with on-prem deployments. Connect an on-prem Leader to Cribl.Cloud to use Cloud infrastructure management, the credit-based billing model, and Cribl Lake and Cribl Search. For example, you can send Cribl metric data to Cribl Lake or Cribl Search, then build dashboards to monitor throughput and performance.
Move data from on-prem to Cribl.Cloud. Onboard data from on-prem Edge Nodes to Cribl.Cloud Edge Nodes without incurring double billing costs. See Send Data from On-Prem to Cribl.Cloud for details.
Connected Environments does not support proxied connections. Make sure the connection between your on-prem Leader and Cribl.Cloud does not pass through a proxy.
To set up Connected Environments, create a connection between the on-prem Leader and the Cribl.Cloud Leader. Then use the Connections page in your Cribl.Cloud account to manage credit consumption for all of your on-prem environments from one interface. This feature is called Universal Subscription.
Understand Environment Compatibility
For supported Stream and Edge combinations, auth tokens, recommended transports, and known limitations, see Cribl-to-Cribl compatibility matrix.
Before You Begin Connecting On-Prem Leaders
Confirm that your environments meet these requirements before you connect an on-prem Leader to Cribl.Cloud:
- Cribl.Cloud plan: Your Cribl.Cloud account uses an Enterprise plan. See Cribl.Cloud pricing.
- On-prem version: Your on-prem Cribl Edge deployment runs version 4.8.2 or newer.
- Distributed mode: Your on-prem deployment runs in Distributed mode. Only a Leader can connect to Cribl.Cloud. Single-instance (standalone) deployments aren’t supported.
- Port: Port
4200is open on the on-prem Leader, using the TCP protocol. - TLS: The connection uses TLS. Cribl Edge enforces TLS for the connection.
- No proxy: The connection does not pass through a proxy.
Connection Methods
Cribl supports two methods for connecting an on-prem Leader to a Cribl.Cloud Leader:
- From the Cribl.Cloud account in Connections > Connected Environments.
- From the on-prem Leader in Distributed Settings > Cloud Connection.
Credits serve as the virtual transaction currency in the Cribl product suite. Each Cribl product has a predefined usage rate, and as you use the products, credits are deducted from your initial pool.
Configuration Considerations
Take these considerations into account for your on-prem Leader, allowlists, security groups, and Workspaces:
- Ports: Make sure that port
4200is open on the Leader, with TCP protocol. See Leader Ports for more information. - TLS: The connection between the Cribl.Cloud Leader and the on-prem Leader
must be encrypted using TLS. When you configure the
CRIBL_CLOUD_WORKSPACE_URLenvironment variable, the value must start withtls://, which enforces TLS. Cribl Edge validates the Cribl.Cloud Leader’s certificate against public certificate authorities, so you can’t disable certificate validation or supply a custom CA path for this connection. - Connection host: The connection URL must point to a Cribl.Cloud hostname,
such as
<your-workspace>-<organization-id>.cribl.cloud. - Static IPs: For IP address allowlist or security group rules, you can find the static IPs of your Cribl.Cloud
Leader in Workspace > Access > Leader NLB IPs. You can also use the
nslookupcommand to obtain static IPs. - Workspaces: Workspaces are separate infrastructure. For allowlists and security groups, ensure that you add each IP address individually as each Workspace has a unique IP.