This extension requires a Java Machine Agent
Elasticsearch is a distributed RESTful search server based on Lucene which provides a distributed multitenant-capable full text search engine. This extension collects metrics using cat endpoints of Elasticsearch REST API and presents them in AppDynamics Metric Browser
Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.
Elasticsearch's HTTP module should be enabled since this extension collects metrics using cat API over HTTP.
- Run 'mvn clean install' from "ElasticsearchMonitorRepo"
- Unzip the contents of "ElasticsearchMonitor-VERSION.zip" from
targets
as "ElasticsearchMonitor" and copy the "ElasticsearchMonitor" directory to<MachineAgentHome>/monitors/
- Configure the extension by referring to the below section.
- Configure the path to the config.yml file by editing the task-arguments in the monitor.xml file.
<task-arguments> <argument name="config-file" is-required="true" default-value="monitors/ElasticsearchMonitor/config.yml" /> </task-arguments>
- Restart the machine agent.
Please place the extension in the "monitors" directory of your Machine Agent installation directory. Do not place the extension in the "extensions" directory of your Machine Agent installation directory.
Note : Please make sure not to use tab (\t) while editing yaml files. You can validate the yaml file using a yaml validator
Configure the extension by editing the config.yml file in <MachineAgentHome>/monitors/ElasticsearchMonitor/
. The metricPrefix of the extension has to be configured as specified here. Please make sure that the right metricPrefix is chosen based on your machine agent deployment, otherwise this could lead to metrics not being visible in the controller.
- Configure the Elasticsearch server in the
servers
section. This is done by configuringdisplayName
(required),uri
(required),username
,password
orencryptedPassword
. Theuri
only consists of thehttp:\\{host}:{port}
, do not configure the complete cat endpoint here. - Next step is setting the
catEndpoints
. All theservers
will share this configuration. To define a cat API you have to provide the following -- endpoint -
/_cat/{cat api name}
. For example to fetch metrics from cat health API, endpoint will be/_cat/health?v
. Please refer to elasticsearch documents for API conventions and list of CAT APIs. - displayName - Used in metric path, all metrics configured for this endpoint will be listed under this display name in the metric browser.
- metricPathKeys - if the cat endpoint has any string value in its output then it can be included in the metric path by providing the header of that column. For example, in the below curl the node name(aliased as name) has string values. When this field is configured as
metricPathKeys: ["name"]
then metrics will be reported as<metricPrefix>|...|N8sjO48|heap.percent
for node nameN8sjO48
curl 'http://localhost:9200/_cat/nodes?v&h=heap.percent,ram.percent,cpu,load_1m,name' heap.percent ram.percent cpu load_1m name 49 98 3 0.47 N8sjO48 53 98 3 0.47 NwL3LHB
- metrics - Configure
name
andproperties
.name
should match the column header in the response returned by theendpoint
.properties
include metric qualifier and metrics transforms.
- endpoint -
Use the following formula for calculating numberOfThreads
numberOfThreads = number of servers *(1 + cat endpoints configured)
for example if there are 7 cat endpoints for one server then numberOfThreads = 1 * (1 + 7) = 8
Please visit this page to get detailed instructions on configuring Metric Path Character sequence replacements in Extensions.
Number Statistics exposed through CAT APIs as mentioned here.
Please visit this page to get detailed instructions on password encryption. The steps in this document will guide you through the whole process.
Workbench is an inbuilt feature provided with each extension in order to assist you to fine tune the extension setup before you actually deploy it on the controller. Please review the following document for how to use the Extensions WorkBench
Please follow the steps listed in the extensions troubleshooting document in order to troubleshoot your issue. These are a set of common issues that customers might have faced during the installation of the extension.
To troubleshoot this extension please follow these steps -
- Ensure that elasticsearch is up and running by executing this command -
This command will return a JSON response and the
curl -v "http://<elasticsearch-host>:<port>"
tagline
will readYou Know, for Search
- If there is a problem in fetching metrics from one of the configured endpoints then run the command -
Ensure that the metric names configured in config.yml matches the names in the header of the response. For example, if there are issues in fetching metrics from cat health api then run the command and ensure that you get a valid output and that the header names match with the configured metric names (
curl -v "http://<elasticsearch-host>:<port>/_cat/<endpoint-configured>?v"
v
parameter in the query is to enable verbose elasticsearch output).curl -v "http://<elasticsearch-host>:<port>/_cat/health?v"
Always feel free to fork and contribute any changes directly via GitHub
Name | Version |
---|---|
Extension Version | 3.0.2 |
Product Tested on | 6.6.2 |
Last Update | 23/09/2021 |
Changes list | ChangeLog |
Note: While extensions are maintained and supported by customers under the open-source licensing model, they interact with agents and Controllers that are subject to AppDynamics’ maintenance and support policy. Some extensions have been tested with AppDynamics 4.5.13+ artifacts, but you are strongly recommended against using versions that are no longer supported.