--- title: Ambari description: Get metrics by host or service for all your ambari managed clusters breadcrumbs: Docs > Integrations > Ambari --- # Ambari Supported OS Integration version6.5.0 ## Overview{% #overview %} This check monitors [Ambari](https://ambari.apache.org) through the Datadog Agent. **Minimum Agent version:** 6.12.0 ## Setup{% #setup %} ### Installation{% #installation %} The Ambari check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server. ### Configuration{% #configuration %} {% tab title="Host" %} #### Host{% #host %} To configure this check for an Agent running on a host: ##### Metric collection{% #metric-collection %} 1. Edit the `ambari.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your Ambari performance data. See the [sample ambari.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/ambari/datadog_checks/ambari/data/conf.yaml.example) for all available configuration options. ```yaml init_config: instances: ## @param url - string - required ## The URL of the Ambari Server, include http:// or https:// # - url: localhost ``` 1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent). ##### Log collection{% #log-collection %} *Available for Agent versions >6.0* 1. Collecting logs is disabled by default in the Datadog Agent. Enable it in your `datadog.yaml` file: ```yaml logs_enabled: true ``` 1. Edit your `ambari.d/conf.yaml` by uncommenting the `logs` lines at the bottom. Update the logs `path` with the correct path to your Ambari log files. ```yaml logs: - type: file path: /var/log/ambari-server/ambari-alerts.log source: ambari service: ambari log_processing_rules: - type: multi_line name: new_log_start_with_date # 2019-04-22 15:47:00,999 pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01]) ... ``` 1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent). {% /tab %} {% tab title="Containerized" %} #### Containerized{% #containerized %} For containerized environments, see the [Autodiscovery Integration Templates](https://docs.datadoghq.com/agent/kubernetes/integrations.md) for guidance on applying the parameters below. ##### Metric collection{% #metric-collection %} | Parameter | Value | | -------------------- | ---------------------------- | | `` | `ambari` | | `` | blank or `{}` | | `` | `{"url": "http://%%host%%"}` | ##### Log collection{% #log-collection %} *Available for Agent versions >6.0* Collecting logs is disabled by default in the Datadog Agent. To enable it, see [Kubernetes Log Collection](https://docs.datadoghq.com/agent/kubernetes/log.md). | Parameter | Value | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `` | `{"source": "ambari", "service": "", "log_processing_rules":{"type":"multi_line","name":"new_log_start_with_date","pattern":"\d{4}-(0?[1-9] | {% /tab %} ### Validation{% #validation %} [Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `ambari` under the Checks section. ## Data Collected{% #data-collected %} This integration collects for every host in every cluster the following system metrics: - boottime - cpu - disk - memory - load - network - process If service metrics collection is enabled with `collect_service_metrics` this integration collects for each included service component the metrics with headers in the inclusion list. ### Metrics{% #metrics %} | | | | | **ambari.boottime**(gauge) | Host boot time.*Shown as millisecond* | | **ambari.cpu.cpu\_idle**(gauge) | Host Idle CPU.*Shown as percent* | | **ambari.cpu.cpu\_nice**(gauge) | Host Nice CPU.*Shown as percent* | | **ambari.cpu.cpu\_num**(gauge) | Host Idle CPU. | | **ambari.cpu.cpu\_system**(gauge) | Host System CPU.*Shown as percent* | | **ambari.cpu.cpu\_user**(gauge) | Host User CPU.*Shown as percent* | | **ambari.cpu.cpu\_wio**(gauge) | Host CPU waiting for IO.*Shown as percent* | | **ambari.disk.disk\_free**(gauge) | Free disk space.*Shown as byte* | | **ambari.disk.disk\_total**(gauge) | Total disk size.*Shown as byte* | | **ambari.disk.read\_bytes**(gauge) | Read bytes.*Shown as byte* | | **ambari.disk.read\_count**(gauge) | Read count. | | **ambari.disk.read\_time**(gauge) | Disk read time.*Shown as millisecond* | | **ambari.disk.write\_bytes**(gauge) | Written bytes.*Shown as byte* | | **ambari.disk.write\_count**(gauge) | Written count. | | **ambari.disk.write\_time**(gauge) | Disk write time.*Shown as millisecond* | | **ambari.load\_fifteen**(gauge) | Load fifteen.*Shown as percent* | | **ambari.load\_five**(gauge) | Load Five.*Shown as percent* | | **ambari.load\_one**(gauge) | Load one.*Shown as percent* | | **ambari.memory.mem\_cached**(gauge) | Cached Memory.*Shown as byte* | | **ambari.memory.mem\_free**(gauge) | Free Memory.*Shown as byte* | | **ambari.memory.mem\_shared**(gauge) | Shared Memory.*Shown as byte* | | **ambari.memory.mem\_total**(gauge) | Total Memory*Shown as byte* | | **ambari.memory.swap\_free**(gauge) | Free Swap*Shown as byte* | | **ambari.memory.swap\_total**(gauge) | Total Swap*Shown as byte* | | **ambari.network.bytes\_in**(gauge) | Network bytes in.*Shown as byte* | | **ambari.network.bytes\_out**(gauge) | Network bytes out.*Shown as byte* | | **ambari.network.pkts\_in**(gauge) | Network packets in.*Shown as byte* | | **ambari.network.pkts\_out**(gauge) | Network packets out.*Shown as byte* | | **ambari.process.proc\_run**(gauge) | Process run. | | **ambari.process.proc\_total**(gauge) | Process total. | ### Events{% #events %} Ambari does not include any events. ### Service Checks{% #service-checks %} **ambari.can\_connect** Returns `OK` if the cluster is reachable, `CRITICAL` otherwise. *Statuses: ok, critical* **ambari.state** Returns `OK` if the service is installed or running, `WARNING` if the service is stopping or uninstalling, `CRITICAL` if the service is uninstalled or stopped. *Statuses: ok, warning, critical* ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).