Skip to content

Commit

Permalink
[DOCS-8074] Add Obs Pipelines Monitoring doc (#25263)
Browse files Browse the repository at this point in the history
* add doc and nav

* small edits

* add metrics doc and nav item

* Apply suggestions from code review

Co-authored-by: Sandra (neko) <[email protected]>

* remove aliases section

* remove note

* add intro to metrics

* add usage metric

* small edit

* Update content/en/observability_pipelines/monitoring/_index.md

---------

Co-authored-by: Sandra (neko) <[email protected]>
  • Loading branch information
maycmlee and neko-dd authored Oct 18, 2024
1 parent 40a2271 commit e2606f9
Show file tree
Hide file tree
Showing 4 changed files with 216 additions and 43 deletions.
92 changes: 51 additions & 41 deletions config/_default/menus/main.en.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -4872,211 +4872,221 @@ menu:
parent: observability_pipelines
identifier: observability_pipelines_advanced_configurations
weight: 4
- name: Monitoring
url: /observability_pipelines/monitoring/
identifier: observability_pipelines_monitoring
parent: observability_pipelines
weight: 5
- name: Metrics
url: /observability_pipelines/monitoring/metrics/
identifier: observability_pipelines_metrics
parent: observability_pipelines_monitoring
weight: 501
- name: Sources
url: observability_pipelines/sources/
parent: observability_pipelines
identifier: observability_pipelines_sources
weight: 5
weight: 6
- name: Datadog Agent
url: observability_pipelines/sources/datadog_agent/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_datadog_agent
weight: 501
weight: 601
- name: Fluent
url: observability_pipelines/sources/fluent/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_fluent
weight: 502
weight: 602
- name: Google Pub/Sub
url: observability_pipelines/sources/google_pubsub/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_google_pubsub
weight: 503
weight: 603
- name: HTTP Client
url: observability_pipelines/sources/http_client/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_http_client
weight: 504
weight: 604
- name: HTTP Server
url: observability_pipelines/sources/http_server/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_http_server
weight: 505
weight: 605
- name: Logstash
url: observability_pipelines/sources/logstash/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_logstash
weight: 506
weight: 606
- name: Splunk HEC
url: observability_pipelines/sources/splunk_hec/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_splunk_hec
weight: 507
weight: 607
- name: Splunk TCP
url: observability_pipelines/sources/splunk_tcp/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_splunk_tcp
weight: 508
weight: 608
- name: Sumo Logic Hosted Collector
url: observability_pipelines/sources/sumo_logic/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_sumo_logic
weight: 509
weight: 609
- name: Syslog
url: observability_pipelines/sources/syslog/
parent: observability_pipelines_sources
identifier: observability_pipelines_sources_syslog
weight: 510
weight: 610
- name: Processors
url: observability_pipelines/processors/
parent: observability_pipelines
identifier: observability_pipelines_processors
weight: 6
weight: 7
- name: Add hostname
url: observability_pipelines/processors/add_hostname
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_add_hostname
weight: 601
weight: 701
- name: Deduplicate
url: observability_pipelines/processors/dedupe
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_dedupe
weight: 602
weight: 702
- name: Edit fields
url: observability_pipelines/processors/edit_fields
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_edit_fields
weight: 603
weight: 703
- name: Enrichment Table
url: observability_pipelines/processors/enrichment_table
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_enrichment_table
weight: 604
weight: 704
- name: Filter
url: observability_pipelines/processors/filter
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_filter
weight: 605
weight: 705
- name: Generate Metrics
url: observability_pipelines/processors/generate_metrics
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_generate_metrics
weight: 606
weight: 706
- name: Grok Parser
url: observability_pipelines/processors/grok_parser
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_grok_parser
weight: 607
weight: 707
- name: Parse JSON
url: observability_pipelines/processors/parse_json
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_parse_json
weight: 608
weight: 708
- name: Quota
url: observability_pipelines/processors/quota
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_quota
weight: 609
weight: 709
- name: Reduce
url: observability_pipelines/processors/reduce
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_reduce
weight: 610
weight: 710
- name: Sample
url: observability_pipelines/processors/sample
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_sample
weight: 611
weight: 711
- name: Sensitive Data Scanner
url: observability_pipelines/processors/sensitive_data_scanner
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_sensitive_data_scanner
weight: 612
weight: 712
- name: Set Environment Variables
url: observability_pipelines/processors/set_environment_variables
parent: observability_pipelines_processors
identifier: observability_pipelines_processors_set_environment_variables
weight: 613
weight: 713
- name: Destinations
url: observability_pipelines/destinations/
parent: observability_pipelines
identifier: observability_pipelines_destinations
weight: 7
weight: 8
- name: Amazon OpenSearch
url: observability_pipelines/destinations/amazon_opensearch/
parent: observability_pipelines_destinations
identifier: observability_pipelines_amazon_opensearch
weight: 701
weight: 801
- name: Amazon S3
identifier: observability_pipelines_destinations_amazon_s3
url: observability_pipelines/destinations/amazon_s3/
parent: observability_pipelines_destinations
weight: 702
weight: 802
- name: Azure Storage
identifier: observability_pipelines_azure_storage
url: observability_pipelines/destinations/azure_storage/
parent: observability_pipelines_destinations
weight: 703
weight: 803
- name: Datadog Logs
url: observability_pipelines/destinations/datadog_logs/
parent: observability_pipelines_destinations
identifier: observability_pipelines_datadog_logs
weight: 704
weight: 804
- name: Elasticsearch
url: observability_pipelines/destinations/elasticsearch/
parent: observability_pipelines_destinations
identifier: observability_pipelines_elasticsearch
weight: 705
weight: 805
- name: Google Chronicle
url: observability_pipelines/destinations/google_chronicle
parent: observability_pipelines_destinations
identifier: observability_pipelines_google_chronicle
weight: 706
weight: 806
- name: Google Cloud Storage
identifier: observability_pipelines_google_cloud_storage
url: /observability_pipelines/destinations/google_cloud_storage/
parent: observability_pipelines_destinations
weight: 707
weight: 807
- name: New Relic
identifier: observability_pipelines_new_relic
url: /observability_pipelines/destinations/new_relic/
parent: observability_pipelines_destinations
weight: 708
weight: 808
- name: OpenSearch
url: observability_pipelines/destinations/opensearch
parent: observability_pipelines_destinations
identifier: observability_pipelines_opensearch
weight: 709
weight: 809
- name: Syslog
url: observability_pipelines/destinations/syslog
parent: observability_pipelines_destinations
identifier: observability_pipelines_syslog
weight: 710
weight: 810
- name: Splunk HEC
url: observability_pipelines/destinations/splunk_hec
parent: observability_pipelines_destinations
identifier: observability_pipelines_splunk_hec
weight: 711
weight: 811
- name: Sumo Logic Hosted Collector
url: observability_pipelines/destinations/sumo_logic_hosted_collector
parent: observability_pipelines_destinations
identifier: observability_pipelines_sumo_logic_hosted_collector
weight: 712
weight: 812
- name: Best Practices for Scaling Observability Pipelines
url: observability_pipelines/best_practices_for_scaling_observability_pipelines/
parent: observability_pipelines
identifier: observability_pipelines_best_practices_for_scaling_observability_pipelines
weight: 8
weight: 9
- name: Guides
url: observability_pipelines/guide/
parent: observability_pipelines
identifier: observability_pipelines_guide
weight: 9
weight: 10
- name: Troubleshooting
url: observability_pipelines/troubleshooting/
identifier: observability_pipelines_troubleshooting
parent: observability_pipelines
weight: 10
weight: 11
- name: Log Management
url: logs/
pre: log
Expand Down
2 changes: 0 additions & 2 deletions content/en/observability_pipelines/legacy/monitoring.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
title: (LEGACY) Monitoring
disable_toc: false
aliases:
- /observability_pipelines/monitoring/
---

{{< site-region region="gov" >}}
Expand Down
73 changes: 73 additions & 0 deletions content/en/observability_pipelines/monitoring/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
title: Monitoring
disable_toc: false
further_reading:
- link: "observability_pipelines/set_up_pipelines"
tag: "Documentation"
text: "Set up a pipeline"
- link: "/monitors/types/metric/"
tag: "Documentation"
text: "Configure a metric monitor"
- link: "/observability_pipelines/monitoring/metrics/"
tag: "Documentation"
text: "Observability Pipelines metrics"
---

## Overview

A pipeline consists of components that collect, process, and route your observability data. You can track the status of your pipelines and components in the following ways:

- View health graphs of your [pipelines](#view-the-status-of-your-pipelines), [Workers](#view-the-status-of-your-workers), and [components](#view-the-status-of-your-pipeline-components) (sources, processors, and destinations).
- Enable [out-of-the-box monitors](#out-of-the-box-monitors) that alert you if:
- An Observability Pipelines Worker has high CPU or memory usage, or is dropping data.
- A component is emitting errors.
- A defined quota has been reached.
- Create your own dashboards, notebooks, and monitors with the available [Observability Pipelines metrics][5].

## View the status of your pipelines

1. Navigate to [Observability Pipelines][1] to see how many bytes your pipelines are receiving and sending out.
1. Select a pipeline.
1. Click the **Health** tab to see details about the pipeline and its components. You can view graphs of:
- How much each component is being used, and the total number of events that the component receives and sends out.
- The number of requests made to destinations, and the number of errors encountered by those requests.
- How many events are intentionally and unintentionally discarded.
- Any changes in the number of requests and errors for each component over the previous week.

You can export a health graph to a dashboard, notebook, or monitor. The exported graph shows you that the metric is grouped by the specific pipeline and component tags.

## View the status of your Workers

To view graphs of resource usage and data sent through Observability Pipelines Workers:

1. Navigate to [Observability Pipelines][1].
1. Select a pipeline.
1. Click the **Workers** tab to see the Workers' memory and CPU utilization, traffic stats, and any errors.

## View the status of your pipeline components

To view metrics for a source, process, or destination:

1. Navigate to [Observability Pipelines][1].
1. Select a pipeline.
1. Click the cog next to the source's, processor's, or destination's name, then select **View details**. Datadog displays health graphs for the component you selected.
1. If you want to export a graph to an [incident][2], [dashboard][3], or [notebook][4], click the export icon on the graph. The exported graph shows that the metric is grouped by the specific pipeline and component tags.

## Out-of-the-box monitors

To see available out-of-the-box monitors:

1. Navigate to [Observability Pipelines][1].
1. Click **Enable monitors** in the **Monitors** column for your pipeline.
1. Click **Start** to set up a monitor for one of the suggested use cases.<br>
The new metric monitor page is configured based on the use case you selected. You can update the configuration to further customize it. See the [Metric monitor documentation][3] for more information.

## Further reading

{{< partial name="whats-next/whats-next.html" >}}

[1]: https://app.datadoghq.com//observability-pipelines/
[2]: /service_management/incident_management/
[3]: /getting_started/dashboards/
[4]: /notebooks/
[5]: /observability_pipelines/monitoring/metrics/
Loading

0 comments on commit e2606f9

Please sign in to comment.