Skip to content

Commit b90a009

Browse files
committed
Update CloudPrem doc
1 parent 4970f73 commit b90a009

22 files changed

+717
-209
lines changed

content/en/cloudprem/_index.md

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,23 @@ private: true
1212

1313
Datadog CloudPrem is a self-hosted log management solution that enables cost-effective log ingestion, processing, indexing, and search capabilities within your own infrastructure. Built to meet data residency, stringent security, and high-volume requirements, CloudPrem integrates with the Datadog platform to provide log analysis, visualization, and alerting — all while keeping your log data at rest within your infrastructure boundaries.
1414

15+
## Key features
16+
17+
- **Self-hosted**: Deploy CloudPrem within your own infrastructure and keep your logs on your object storage
18+
- **Cost-effective**: Reduce log management infra costs while maintaining full observability
19+
- **Scalable**: Horizontally scalable architecture to handle high-volume log ingestion
20+
- **Integrated in Datadog**
21+
1522
## Get started
1623

24+
Follow these steps to deploy and configure CloudPrem:
25+
1726
{{< whatsnext >}}
18-
{{< nextlink href="/cloudprem/installation/" >}}Install CloudPrem and Send Logs with the Agent {{< /nextlink >}}
19-
{{< nextlink href="/cloudprem/ingress/" >}}Configure CloudPrem Ingress{{< /nextlink >}}
20-
{{< nextlink href="/cloudprem/aws_config" >}}Configure AWS{{< /nextlink >}}
21-
{{< nextlink href="/cloudprem/processing/" >}}Configure CloudPrem Log Processing{{< /nextlink >}}
22-
{{< nextlink href="/cloudprem/cluster/" >}}Learn more about Cluster Sizing and Operations{{< /nextlink >}}
23-
{{< nextlink href="/cloudprem/architecture/" >}}Learn more about CloudPrem Architecture{{< /nextlink >}}
27+
{{< nextlink href="/cloudprem/overview/" >}}Overview{{< /nextlink >}}
28+
{{< nextlink href="/cloudprem/install/" >}}Install CloudPrem{{< /nextlink >}}
29+
{{< nextlink href="/cloudprem/ingest-logs/" >}}Set up Log Ingestion{{< /nextlink >}}
30+
{{< nextlink href="/cloudprem/configure/" >}}Configure CloudPrem{{< /nextlink >}}
31+
{{< nextlink href="/cloudprem/manage/" >}}Manage and Monitor{{< /nextlink >}}
32+
{{< nextlink href="/cloudprem/supported-features/" >}}Supported Features{{< /nextlink >}}
2433
{{< nextlink href="/cloudprem/troubleshooting/" >}}Troubleshooting{{< /nextlink >}}
2534
{{< /whatsnext >}}
26-
27-
28-
[1]: https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/deploy/installation/
29-
[2]: /cloudprem/installation/
30-
[3]: /cloudprem/processing/
31-
[4]: /cloudprem/architecture/
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Configure CloudPrem
3+
description: Learn how to configure and customize your CloudPrem deployment for optimal performance and security
4+
private: true
5+
---
6+
7+
## Overview
8+
9+
After installing CloudPrem, you need to [configure your Datadog account](datadog-account/), and optionally adjust the [cluster size](cluster-sizing/), configure [ingress](ingress/) and/or [processing](processing/).
10+
11+
## Next steps
12+
13+
{{< whatsnext >}}
14+
{{< nextlink href="./datadog-account/" >}}Configure your Datadog account{{< /nextlink >}}
15+
{{< nextlink href="./ingest-logs/" >}}Send logs to CloudPrem{{< /nextlink >}}
16+
{{< nextlink href="../manage/" >}}Monitor CloudPrem{{< /nextlink >}}
17+
{{< /whatsnext >}}

content/en/cloudprem/cluster.md renamed to content/en/cloudprem/configure/cluster-sizing.md

Lines changed: 4 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,16 @@
11
---
2-
title: Cluster Sizing and Operations
3-
description: Learn about cluster sizing, scaling, monitoring, and maintenance for CloudPrem
2+
title: Cluster Sizing
3+
description: Learn about cluster sizing for CloudPrem
44
private: true
55
further_reading:
6-
- link: "/cloudprem/"
7-
tag: "Documentation"
8-
text: "CloudPrem Overview"
9-
- link: "/cloudprem/installation/"
10-
tag: "Documentation"
11-
text: "Install CloudPrem and Send Logs with the Agent"
12-
- link: "/cloudprem/ingress/"
6+
- link: "/cloudprem/configure/ingress/"
137
tag: "Documentation"
148
text: "Configure CloudPrem Ingress"
15-
- link: "/cloudprem/aws_config"
16-
tag: "Documentation"
17-
text: "Configure AWS"
18-
- link: "/cloudprem/processing/"
199
tag: "Documentation"
2010
text: "Configure CloudPrem Log Processing"
21-
- link: "/cloudprem/architecture/"
11+
- link: "/cloudprem/overview/architecture/"
2212
tag: "Documentation"
2313
text: "Learn more about CloudPrem Architecture"
24-
- link: "/cloudprem/troubleshooting/"
25-
tag: "Documentation"
26-
text: "Troubleshooting"
2714
---
2815

2916
<div class="alert alert-warning">CloudPrem is in Preview.</div>
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: Configure your Datadog account
3+
description: Set up your Datadog account to access CloudPrem logs
4+
private: true
5+
further_reading:
6+
- link: "/cloudprem/ingest-logs/datadog-agent/"
7+
tag: "Documentation"
8+
text: "Set up log ingestion with Datadog Agent"
9+
- link: "/cloudprem/configure/ingress/"
10+
tag: "Documentation"
11+
text: "Configure CloudPrem Ingress"
12+
- link: "/cloudprem/manage/"
13+
tag: "Documentation"
14+
text: "Manage and Monitor CloudPrem"
15+
---
16+
17+
You need to reach out to [Datadog support](/help/) and give the public DNS of your CloudPrem cluster so that you can search into CloudPrem logs from Datadog UI.
18+
19+
### Searching your CloudPrem logs in the Logs Explorer
20+
21+
After your Datadog account is configured, you are ready to search into the `cloudprem` index by typing it in the search bar or selecting it in facets.
22+
23+
**Note**: You cannot query CloudPrem indexes alongside other indexes. Additionally, Flex Logs are not supported with CloudPrem indexes.
24+
25+
{{< img src="/cloudprem/installation/filter_index_cloudprem.png" alt="Screenshot of the Logs Explorer interface showing how to filter logs by selecting the cloudprem index in the facets panel" style="width:70%;" >}}
26+
27+
## Further reading
28+
29+
{{< partial name="whats-next/whats-next.html" >}}

content/en/cloudprem/ingress.md renamed to content/en/cloudprem/configure/ingress.md

Lines changed: 13 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -6,28 +6,23 @@ further_reading:
66
- link: "/cloudprem/"
77
tag: "Documentation"
88
text: "CloudPrem Overview"
9-
- link: "/cloudprem/installation/"
9+
- link: "/cloudprem/install/"
1010
tag: "Documentation"
11-
text: "Install CloudPrem and Send Logs with the Agent"
12-
- link: "/cloudprem/aws_config"
11+
text: "Install CloudPrem"
12+
- link: "/cloudprem/install/aws_config/"
1313
tag: "Documentation"
14-
text: "Configure AWS"
15-
- link: "/cloudprem/processing/"
14+
text: "AWS Configuration Prerequisites"
15+
- link: "/cloudprem/configure/"
1616
tag: "Documentation"
17-
text: "Configure CloudPrem Log Processing"
18-
- link: "/cloudprem/cluster/"
17+
text: "Configure CloudPrem"
18+
- link: "/cloudprem/ingest-logs/"
1919
tag: "Documentation"
20-
text: "Learn more about Cluster Sizing and Operations"
21-
- link: "/cloudprem/architecture/"
20+
text: "Set up Log Ingestion"
21+
- link: "/cloudprem/manage/"
2222
tag: "Documentation"
23-
text: "Learn more about CloudPrem Architecture"
24-
- link: "/cloudprem/troubleshooting/"
25-
tag: "Documentation"
26-
text: "Troubleshooting"
23+
text: "Manage and Monitor"
2724
---
2825

29-
<div class="alert alert-warning">CloudPrem is in Preview.</div>
30-
3126
## Overview
3227

3328
Ingress is a critical component of your CloudPrem deployment. The Helm chart automatically creates two ingress configurations called public ingress and internal ingress. If the AWS Load Balancer Controller is installed on the cluster, it provisions one ALB per ingress configuration. Each load balancer can be further configured using ingress annotations.
@@ -46,7 +41,7 @@ The public ingress is essential for enabling Datadog's control plane and query s
4641

4742
This setup ensures that only authenticated Datadog services can access the CloudPrem cluster while maintaining secure encrypted communication end-to-end.
4843

49-
{{< img src="/cloudprem/ingress/public_ingress.png" alt="Diagram showing CloudPrem public ingress architecture with Datadog services connecting through an internet-facing AWS ALB using mTLS authentication to access the CloudPrem gRPC API" style="width:100%;" >}}
44+
{{< img src="/cloudprem/images/public_ingress.png" alt="Diagram showing CloudPrem public ingress architecture with Datadog services connecting through an internet-facing AWS ALB using mTLS authentication to access the CloudPrem gRPC API" style="width:100%;" >}}
5045

5146
### IP Allowlisting
5247

@@ -61,7 +56,7 @@ curl -X GET "https://ip-ranges.datadoghq.eu/" \
6156

6257
The internal ingress enables log ingestion from Datadog Agents and other log collectors within your environment through HTTP.
6358

64-
{{< img src="/cloudprem/ingress/internal_ingress.png" alt=" Internal ingress with ALB provisioned by Helm chart" style="width:100%;" >}}
59+
{{< img src="/cloudprem/images/internal_ingress.png" alt=" Internal ingress with ALB provisioned by Helm chart" style="width:100%;" >}}
6560

6661
By default, the chart creates an internal AWS Application Load Balancer (ALB) to route HTTP traffic to the appropriate CloudPrem services based on the requested API endpoint path. However, if you prefer to use your own ingress controller (such as HAProxy, NGINX, or Traefik), you can disable the default internal ALB and configure your controller with the following routing rules:
6762

@@ -117,7 +112,7 @@ rules:
117112
118113
```
119114

120-
{{< img src="/cloudprem/ingress/internal_ingress_nginx_controller.png" alt="CloudPrem internal ingress configuration using NGINX ingress controller showing path routing to indexer, metastore, and searcher services" style="width:100%;" >}}
115+
{{< img src="/cloudprem/images/internal_ingress_nginx_controller.png" alt="CloudPrem internal ingress configuration using NGINX ingress controller showing path routing to indexer, metastore, and searcher services" style="width:100%;" >}}
121116

122117
## Further reading
123118

content/en/cloudprem/processing.md renamed to content/en/cloudprem/configure/processing.md

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,25 +3,10 @@ title: Processing Configuration
33
description: Learn how to configure your processing pipelines in CloudPrem
44
private: true
55
further_reading:
6-
- link: "/logs/log_configuration/processors/"
7-
tag: "Documentation"
8-
text: "Datadog Log Management Processors"
9-
- link: "/cloudprem/"
10-
tag: "Documentation"
11-
text: "CloudPrem Overview"
12-
- link: "/cloudprem/installation/"
6+
- link: "/cloudprem/install/"
137
tag: "Documentation"
148
text: "Install CloudPrem and Send Logs with the Agent"
15-
- link: "/cloudprem/ingress/"
16-
tag: "Documentation"
17-
text: "Configure CloudPrem Ingress"
18-
- link: "/cloudprem/aws_config"
19-
tag: "Documentation"
20-
text: "Configure AWS"
21-
- link: "/cloudprem/cluster/"
22-
tag: "Documentation"
23-
text: "Learn more about Cluster Sizing and Operations"
24-
- link: "/cloudprem/architecture/"
9+
- link: "/cloudprem/overview/architecture/"
2510
tag: "Documentation"
2611
text: "Learn more about CloudPrem Architecture"
2712
- link: "/cloudprem/troubleshooting/"
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: Set up Log Ingestion
3+
description: Configure log sources to send data to your CloudPrem deployment
4+
private: true
5+
---
6+
7+
<div class="alert alert-warning">CloudPrem is in Preview.</div>
8+
9+
## Overview
10+
11+
After installing and configuring CloudPrem, you need to set up log ingestion to start sending log data from your applications and infrastructure. CloudPrem supports multiple ingestion methods to accommodate different architectures and requirements.
12+
13+
## Log ingestion methods
14+
15+
Choose the appropriate ingestion method based on your infrastructure and requirements:
16+
17+
{{< whatsnext >}}
18+
{{< nextlink href="/cloudprem/ingest-logs/datadog-agent/" >}}Datadog Agent{{< /nextlink >}}
19+
{{< nextlink href="/cloudprem/ingest-logs/observability-pipelines/" >}}Observability Pipelines{{< /nextlink >}}
20+
{{< nextlink href="/cloudprem/ingest-logs/rest-api/" >}}REST API Integration{{< /nextlink >}}
21+
{{< /whatsnext >}}
22+
23+
## Next steps
24+
25+
After setting up log ingestion:
26+
27+
1. **Configure Datadog account** - Register your CloudPrem deployment with Datadog support
28+
2. **Set up monitoring** - Add [monitoring and alerts](../manage/) for your deployment
29+
30+
## Further reading
31+
32+
{{< partial name="whats-next/whats-next.html" >}}

0 commit comments

Comments
 (0)