---
title: Hbase Master
description: HBase master integration.
breadcrumbs: Docs > Integrations > Hbase Master
---

# Hbase Master
Supported OS Integration version1.1.1
## Overview{% #overview %}

Get metrics from Hbase_master service in real time to:

- Visualize and monitor Hbase_master states.
- Be notified about Hbase_master failovers and events.

## Setup{% #setup %}

The Hbase_master check is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you need to install it.

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the Hbase_master check on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations.md) to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   ```shell
   datadog-agent integration install -t datadog-hbase_master==<INTEGRATION_VERSION>
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/getting_started/integrations.md).

### Configuration{% #configuration %}

1. Edit the `hbase_master.d/conf.yaml` file in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files.md#agent-configuration-directory) to start collecting your Hbase_master metrics. See the [sample hbase_master.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/hbase_master/datadog_checks/hbase_master/data/conf.yaml.example) for all available configuration options.

**NOTE**: If using Agent 6, be sure to modify the [`hbase_master.d/metrics.yaml`](https://github.com/DataDog/integrations-extras/blob/master/hbase_master/datadog_checks/hbase_master/data/metrics.yaml) file and wrap boolean keys in quotes.

   ```yaml
     - include:
         domain: Hadoop
         bean:
           - Hadoop:service=HBase,name=Master,sub=Server
         attribute:
           # Is Active Master
           tag.isActiveMaster:
              metric_type: gauge
              alias: hbase.master.server.tag.is_active_master
              values: {"true": 1, "false": 0, default: 0}
   ```

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent)

### Log collection{% #log-collection %}

1. Collecting logs is disabled by default in the Datadog Agent, you need to enable it in `datadog.yaml`:

   ```yaml
   logs_enabled: true
   ```

1. Add this configuration block to your `hbase_master.d/conf.yaml` file to start collecting your Hbase_master Logs:

   ```yaml
   logs:
     - type: file
       path: /path/to/my/directory/file.log
       source: hbase
   ```

Change the `path` parameter value and configure it for your environment. See the [sample hbase_master.d/conf.yaml](https://docs.datadoghq.com/agent/guide/agent-commands.md#service-status) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

### Validation{% #validation %}

Run the [Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#service-status) and look for `hbase_master` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **hbase.master.assignmentmanager.rit\_oldest\_age**(gauge)            | The age of the longest region in transition, in milliseconds*Shown as millisecond* |
| **hbase.master.assignmentmanager.rit\_count\_over\_threshold**(gauge) | The number of regions that have been in transition longer than a threshold time    |
| **hbase.master.assignmentmanager.rit\_count**(gauge)                  | The number of regions in transition                                                |
| **hbase.master.assignmentmanager.assign.min**(gauge)                  |
| **hbase.master.assignmentmanager.assign.max**(gauge)                  |
| **hbase.master.assignmentmanager.assign.mean**(gauge)                 |
| **hbase.master.assignmentmanager.assign.median**(gauge)               |
| **hbase.master.assignmentmanager.assign.percentile.99**(gauge)        |
| **hbase.master.ipc.queue\_size**(gauge)                               | Number of bytes in the call queues.*Shown as byte*                                 |
| **hbase.master.ipc.num\_calls\_in\_general\_queue**(gauge)            | Number of calls in the general call queue.                                         |
| **hbase.master.ipc.num\_calls\_in\_replication\_queue**(gauge)        | Number of calls in the replication call queue.                                     |
| **hbase.master.ipc.num\_calls\_in\_priority\_queue**(gauge)           | Number of calls in the priority call queue.                                        |
| **hbase.master.ipc.num\_open\_connections**(gauge)                    | Number of open connections.                                                        |
| **hbase.master.ipc.num\_active\_handler**(gauge)                      | Number of active rpc handlers.                                                     |
| **hbase.master.ipc.total\_call\_time.max**(gauge)                     | total call time, including both queued and processing time.*Shown as millisecond*  |
| **hbase.master.ipc.total\_call\_time.mean**(gauge)                    | total call time, including both queued and processing time.*Shown as millisecond*  |
| **hbase.master.ipc.total\_call\_time.median**(gauge)                  | total call time, including both queued and processing time.*Shown as millisecond*  |
| **hbase.master.ipc.total\_call\_time.percentile.99**(gauge)           | total call time, including both queued and processing time.*Shown as millisecond*  |
| **hbase.master.server.tag.is\_active\_master**(gauge)                 | Is Active Master                                                                   |
| **hbase.master.server.num\_region\_servers**(gauge)                   | Number of RegionServers                                                            |
| **hbase.master.server.num\_dead\_region\_servers**(gauge)             | Number of dead RegionServers                                                       |

### Events{% #events %}

The Hbase_master check does not include any events.

### Service Checks{% #service-checks %}

The Hbase_master check does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](http://docs.datadoghq.com/help).