Skip to content

Commit

Permalink
Merge pull request #9688 from DataDog/yael/istio_updates
Browse files Browse the repository at this point in the history
Yael/istio docs updates
  • Loading branch information
kayayarai authored Feb 4, 2021
2 parents 2f12252 + c62dd34 commit dc1a01c
Show file tree
Hide file tree
Showing 2 changed files with 51 additions and 19 deletions.
56 changes: 43 additions & 13 deletions content/en/network_monitoring/performance/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,41 +16,68 @@ further_reading:
text: 'Network Widget'
---

Datadog Network Performance Monitoring (NPM) gives you visibility into your network traffic between services, containers, availability zones, and any other tag in Datadog so you can:

- Pinpoint unexpected or latent service dependencies.
- Optimize costly cross-regional or multi-cloud communication.
- Identify outages of cloud provider regions and third-party tools.
- Troubleshoot faulty service discovery with DNS server metrics.

Network performance monitoring requires [Datadog Agent v6.14+][1].

Supported **platforms** include:
## Supported Platforms

### Operating Systems

#### Linux OS

Data collection is done using eBPF, so Datadog minimally requires platforms that have underlying Linux kernel versions of 4.4.0+. NPM supports the following Linux distributions:

- Ubuntu 16.04+
- Debian 9+
- Fedora 26+
- SUSE 15+
- Amazon AMI 2016.03+
- Amazon Linux 2
- [Windows Server 2016+][2] (in public beta)

**For Linux OS:** Data collection is done using eBPF, so Datadog minimally requires platforms that have underlying Linux kernel versions of 4.4.0+.
**Note:** There is an exception to the 4.4.0+ kernel requirement for [CentOS/RHEL 7.6+][3]. The [DNS Resolution][4] feature is not supported on CentOS/RHEL 7.6.

#### Windows OS

Data collection is done using a device driver, and support is available in [public beta for Windows Server 2016 or later][2].

#### macOS

Datadog Network Performance Monitoring does not currently support macOS platforms.

### Container Setups

NPM helps you visualize the architecture and performance of your containerized and orchestrated environments, with support for [Docker][13], [Kubernetes][14], [ECS][15], and other container technologies. Datadog’s container integrations enable you to aggregate traffic by meaningful entities -- such as containers, tasks, pods, clusters, and deployments -- with out-of-the -box tags (such as `container_name`, `task_name`, `kube_service`).

### Network Routing Tools

**For Windows OS:** Data collection is available in public beta for Windows Server 2016 or later.
#### Istio

There is an exemption to the 4.4.0+ kernel requirement for [CentOS/RHEL 7.6+][3]. The [DNS Resolution][4] feature is not supported on CentOS/RHEL 7.6.
With NPM, you can map network communication between containers, pods, and services over the Istio service mesh.

**Istio** v1.6.4+ is supported by [Datadog Agent v7.24.1+][1]. To use Istio, download the correct version of the Agent.
Datadog monitors every aspect of your Istio environment, so you can also:
- Assess the health of Envoy and the Istio control plane with [logs][6].
- Break down the performance of your service mesh with request, bandwidth, and resource consumption [metrics][6].
- Drill into distributed traces for applications transacting over the mesh with [APM][7].

Datadog monitors every aspect of your Istio setup, including:
NPM supports Istio v1.6.4+ with [Datadog Agent v7.24.1+][1].

- [Container and pod-level flow data][5] (using NPM)
- [Metrics and logs][6] (using the Istio Agent Check)
- [Application distributed traces][7] (using APM)
To learn more about monitoring your Istio environment with Datadog, [see the Istio blog][8].

To learn more about monitoring your Istio environment with Datadog, see the [Istio blog][8].
#### Cilium

Network Performance Monitoring is compatible with **Cilium** installations, provided the following requirements are met:
1) Cilium version 1.6 and above, and
2) Kernel version 5.1.16 and above, or 4.19.57 and above for 4.19.x kernels

**Note**: Datadog does not support macOS platforms for Network Performance Monitoring.
### Provisioning Systems

The following **provisioning systems** are supported:
Network Performance Monitoring supports use of the following provisioning systems:

- Daemonset / Helm 1.38.11+: See the [Datadog Helm chart][9]
- Chef 12.7+: See the [Datadog Chef recipe][10]
Expand Down Expand Up @@ -388,3 +415,6 @@ To set up on AWS ECS, see the [AWS ECS][1] documentation page.
[10]: https://github.com/DataDog/chef-datadog
[11]: https://github.com/DataDog/ansible-datadog/blob/master/README.md#system-probe
[12]: /agent/guide/agent-configuration-files/#agent-main-configuration-file
[13]: https://docs.datadoghq.com/integrations/docker_daemon/
[14]: https://docs.datadoghq.com/agent/kubernetes/
[15]: https://docs.datadoghq.com/agent/amazon_ecs/
14 changes: 8 additions & 6 deletions content/en/tracing/setup_overview/proxy_setup/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -382,11 +382,13 @@ The above overrides the default `nginx-ingress-controller.ingress-nginx` service
{{% /tab %}}
{{% tab "Istio" %}}

Datadog monitors every aspect of your Istio setup, including:
Datadog monitors every aspect of your Istio environment, so you can:
- Drill into distributed traces for applications transacting over the mesh with APM (see below).
- Assess the health of Envoy and the Istio control plane with [logs][1].
- Break down the performance of your service mesh with request, bandwidth, and resource consumption [metrics][1].
- Map network communication between containers, pods, and services over the mesh with [Network Performance Monitoring][2].

- Application distributed traces (see below)
- [Metrics and logs][1] (using the Istio Agent Check)
- [Container and pod-level flow data][2] (using Network Performance Monitoring)
To learn more about monitoring your Istio environment with Datadog, [see the Istio blog][10].

## Configuration

Expand Down Expand Up @@ -495,18 +497,18 @@ If using Kubernetes 1.18+, `appProtocol: tcp` can be added to the port specifica
[1]: /integrations/istio/
[2]: https://www.datadoghq.com/blog/monitor-istio-with-npm/
[2]: /network_monitoring/performance/setup/#istio
[3]: /agent/kubernetes/
[4]: /agent/kubernetes/apm/
[5]: https://istio.io/docs/setup/install/istioctl/
[6]: https://istio.io/docs/ops/configuration/traffic-management/protocol-selection/
[7]: https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/
[8]: /tracing/setup/cpp/#environment-variables
[9]: https://istio.io/docs/ops/configuration/traffic-management/protocol-selection/#manual-protocol-selection
[10]: https://www.datadoghq.com/blog/istio-datadog/
{{% /tab %}}
{{< /tabs >}}
## Further Reading
{{< partial name="whats-next/whats-next.html" >}}

0 comments on commit dc1a01c

Please sign in to comment.