Monitoring MapR
You can monitor MapR with the Instana MapR sensor to track the performance and health of your MapR nodes. The MapR sensor is automatically deployed and installed after you install the Instana agent. You can then view the related metrics in the Instana UI.
MapR was later updated and reintroduced as Data Fabric.
Prerequisites
Before you configure the MapR sensor, make sure that the following prerequisites are met:
- The Instana host agent is installed. See Installing host agents.
- The MapR sensor is compatible with your current setup. See Support information.
Support information
To help ensure sensor compatibility with your environment, check the following sections:
Supported operating systems
The MapR sensor currently supports Linux.
Supported versions
The following table shows the latest supported version of MapR and the Instana support policy:
| Technology | Support policy | Latest technology version | Latest supported version |
|---|---|---|---|
| MapR | On demand | 7.9.0 | 6.0.0 |
For more information about the support policy, see Support strategy for sensors.
Configuring the MapR sensor
By default, MapR monitoring is enabled on Instana. The MapR sensor supports local monitoring. Local monitoring of MapR involves setting up the Instana agent on the same host as your MapR nodes.
Local monitoring
Instana agent uses the following configuration to connect MapR. You can update the configuration in the agent configuration file (<agent_install_dir>/etc/instana/configuration.yaml).
#MapR
com.instana.plugin.mapr:
enabled: true # To enable the sensor, set its value to ‘true’.
poll_rate: 30 #Default value is 10 seconds.
To disable MapR monitoring, set the
enabled
parameter to
false.
Viewing metrics
To view the metrics related to MapR, complete the following steps:
- From the navigation menu in the Instana UI, select Infrastructure.
- On the infrastructure map, select your MapR monitored host, and click the MapR node slice.
- To display the MapR node dashboard, click Open Dashboard.
You can view the dashboard with all the collected metrics and monitored processes.
MapR node
You can view the following configuration data and metrics for your MapR node:
Configuration data
The following table lists the configuration details:
| Node details | Description |
|---|---|
| Process ID | PID of the node process |
| Cluster Name | Name of the cluster |
| Node Name | Name of the node |
| Version | Software version running on the cluster |
| Rack topology | Rack topology path for the node |
| Configured Service | Services configured to run on this node |
| Health | Status of node health |
| Health Description | Explanation of health |
MapR Node metrics
The following table lists the metric details:
| Metrics Name | Description |
|---|---|
| MapR file system disks | Number of disks that are allocated for the file system on MapR |
| Failed disks | Number of failed filesystem disks on the node |
| Number of Disks | The total number of physical or logical disks detected and reported on the node |
| Number of CPU | The number of logical CPU cores available on the node |
| CPU Utilization | CPU usage in percentage |
| Used Space | Disk space used on the node |
| Available Space | Disk space available on the node |
| Used Space Percent | Utilized Space Percentage |
| Reads | Disk read count since the last heartbeat |
| Writes | Disk write count since the last heartbeat |
| Reads | Throughput of disk read operations |
| Writes | Throughput of disk write operations |
The following table provides metric details for disks attached to MapR:
| Metrics Name | Description |
|---|---|
| Disk name | Name of the disk or partition |
| Total space | Number of failed filesystem disks on the node |
| Used space | Disk space used |
| Used space percent | Disk space used in percentage |
| Available space | Disk space available |
| Health status | Disk status |
| Mount | Disk mount status |
| File system type | Filesystem type identifier |
MapR cluster metrics
You can view the following configuration data and metrics for your MapR cluster:
Configuration data
The following table lists the configuration details:
| Node details | Description |
|---|---|
| Cluster Name | Name of the cluster |
MapR cluster metrics
The following table lists the metric details:
| Metrics name | Description |
|---|---|
| Nodes connected | Number of nodes that are connected to Instana |
| Nodes configured | Number of nodes that are configured in the cluster |
| Total MapR file system disks | Number of disks that are configured in the cluster |
| Service name | Name of the service that is configured in the cluster |
| Active | Number of active services on the cluster |
| Stopped | Number of stopped services on the cluster |
| Failed | Number of failed services on the cluster |
| Total | Number of total services on the cluster |
Troubleshooting
To ensure reliably data collection by the Instana MapR sensor,
verify that the necessary CLI commands run without errors. Failures
or permission issues might prevent the sensor from gathering data
correctly. These issues are often resolved by confirming that the
maprcli is accessible to the root user, which is
critical for the sensor to function as expected.