You are on page 1of 14

Trianz Appdynamics Agent Documentation

Installation and Config Document


Appd Agents: Database Agent

Ed Dr0.1 Appdynamics db agent deployment Trianz 1/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Document Approval
Names of the persons approving this document for release.

Trianz Internal Approval

Role

Name

Role

Name

Role

Name

Document History
The purpose of this section is to capture all changes made to the content of document

Edition Date Author Details of Change

Draft 0.1 20/03/20 M Sekhara Reddy Initial Draft


17

Table 1 – Document History

Ed Dr0.1 Appdynamics db agent deployment Trianz 2/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Document Location
Location of document in the Trianz Trinet

Electronic Location

Table 2 – Document Location

Ed Dr0.1 Appdynamics db agent deployment Trianz 3/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Table of Contents
1. Introduction.................................................................................................7
1.1 Purpose................................................................................................ 7
1.2 Scope.................................................................................................. 7
1.3 Referenced Documents.............................................................................7
1.4 Acronyms and Terms................................................................................7
1.5 Additional remarks and agreements..............................................................7
2. Appdynamics Agent Installation.........................................................................8
2.1 Database agent Installation & configuration steps..............................................8
2.1.1 Downloading db agent...................................................................8
2.1.2 Installing and configuring db agent....................................................8
2.1.3 Starting dbagent..........................................................................9
3. Configuring MYSQL using db-agent....................................................................10
3.1 Controller UI Steps to add MYSQL db collector................................................10
4. Monitoring MYSQL dashboard && Metrics............................................................12
4.1 Accessing MYSQL Dashboard......................................................................12
4.2 Accessing MYSQL Metrics using Metric Browser................................................14
5. Appdynamics DB-Agent logs Information.............................................................14

Ed Dr0.1 Appdynamics db agent deployment Trianz 4/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Table of Tables

Table 1 – Document History................................................................................2


Table 2 – Document Location..............................................................................3
Table 3 – References Documents..........................................................................7
Table 4 – Acronyms and Terms............................................................................7

Ed Dr0.1 Appdynamics db agent deployment Trianz 5/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

1. Introduction
1.1 Purpose
The purpose of the Solution Architecture & High Level Design (SA&HLD) document is to
define the system level solution for the Three Ireland project.

1.2 Scope

1.3 Referenced Documents

Ref Document Number Document Title Version

Table 3 – References Documents

1.4 Acronyms and Terms


Specific acronyms and terms used in this document are listed below.

HL High Level
D Design

Table 4 – Acronyms and Terms

1.5 Additional remarks and agreements

Not Applicable.

Ed Dr0.1 Appdynamics db agent deployment Trianz 6/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

2. Appdynamics Agent Installation


2.1 Database agent Installation & configuration steps
2.1.1 Downloading db agent
Go to this URL https://download.appdynamics.com/download/ by using client partnership
ID’s or get the db agent software from client repository
Note: Download the db agent based on Operating System (Linux/windows) as like below

2.1.2 Installing and configuring db agent


 Move the dbagent software(dbagent-4.2.11.0.zip) to the location where we have
specific directory/mount point to install the agents , if no specification given then
copy in /opt/appdbagent/ and unzip it finally

 Configure the dbagent to report it to controller by following below steps

Go to agent installed directory and look for conf directory, inside that you can see
“controller-info.xml” and open the file using VI editor or notepad based on your OS
type

<controller-host>** provide hostname/IP of the controller server ** </controller-host>


<controller-port> ** provide the port of the controller – default is 8090 **</controller-
port>
<controller-ssl-enabled>false</controller-ssl-enabled> ** if ssl used, update as true”
<account-name>** Povide the account name found from controller UI – default is
customer 1**</account-name>

Ed Dr0.1 Appdynamics db agent deployment Trianz 7/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

<account-access-key> ** provide the access key found from controller UI**</account-


access-key>

Note: You can get the account name and access key from Controller UI like shown in below
(click on fog icon or settings icon shown right upper corner side in UI)

2.1.3 Starting dbagent

Once if above steps are peformed to configure the db agent successfully, then we can start
the db agent by using below command

1) First go to dg agent installed directory


2) Run below command on terminal

java –jar db-agent.jar &


3) Wait for 30 seconds and login controller UI to see if agent is reporing or not as shown
below

Ed Dr0.1 Appdynamics db agent deployment Trianz 8/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

3. Configuring MYSQL using db-agent

3.1 Controller UI Steps to add MYSQL db collector

1. Login in Controller UI by using your credentials and click on databases and Getstarted as
shown below screen

2. Post clicking on Get Started option , you can see below screen

Ed Dr0.1 Appdynamics db agent deployment Trianz 9/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Here select mysql and follow below screen to provide mysql details like below

Ed Dr0.1 Appdynamics db agent deployment Trianz 10/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Post providing above details, click on continue to complete mysql db-collector configuration
successfully

Ed Dr0.1 Appdynamics db agent deployment Trianz 11/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

4. Monitoring MYSQL dashboard && Metrics


4.1 Accessing MYSQL Dashboard

1. Login in Controller UI using your credentials and click on dashboards, you can see
below screen

2. Click on Mysql-ControllerDB, further to navigate on appd db default dashboard to see


more details about mysql performance as shown below

Ed Dr0.1 Appdynamics db agent deployment Trianz 12/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

Note: click on highlighted tabs like Live View, Queries, and Sessions etc to see detailed
performance of Mytsql database Pefomance.

Ed Dr0.1 Appdynamics db agent deployment Trianz 13/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.
Trianz Appdynamics Agent Documentation

4.2 Accessing MYSQL Metrics using Metric Browser

 Post login in Controller UI, click on databases and click on Metric browser show
in left side navigation view and you can see below screen

In Above, KPI’s are highlighted are most important metrics for any database getting monitored,
further can be navigated to see other metrics as well, based on above metrics Health Rules can be
written to suit client requirements.

5. Appdynamics DB-Agent logs Information

 Go to DB-Agent installed directory and you can find logs directory listed there
 Got to logs directory and you can access agent.log file to see if any errors
related to db agent and you can find below entry if db agent started
succesfully

********************** END of the Document **************************************

Ed Dr0.1 Appdynamics db agent deployment Trianz 14/14


Copyright © 2017 Trianz Pvt Ltd. All rights reserved.

You might also like