forked from Appdynamics/pcf-appdynamics-platform-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathinstalling.html.md.erb
87 lines (56 loc) · 5.47 KB
/
installing.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
---
title: Installing and Configuring AppDynamics Platform Monitoring
owner: Partners
---
This topic describes how to install and configure Appdynamics Platform Metrics in Pivotal Cloud Foundry (PCF).
## <a id='overview-appd-nozzle'></a> Overview
AppDynamics Nozzle aggregates and forwards logs and metrics from the Loggregator Firehose to the AppDynamics Controller. The Controller process that data and provides the performance metrics of the underlying infrastructure of apps running on PCF. You can view them in the Metric Browser corresponding to the Nozzle application.
When you successfully configure AppDynamics Nozzle on PCF, a default application named appd-nozzle, is created on the AppDynamics Controller. Additionally, a default tier named appd-nozzle-tier and a default node named appd-nozzle-node are created under which corresponding metrics are recorded.
## <a id='before-you-start'></a> Before You Start
Do the following:
1. Create a [Pivotal Network](https://network.pivotal.io) account if you do not have one.
1. [Set up the AppDynamics Controller](https://docs.appdynamics.com/display/PRO45/Controller+Deployment).
1. Acquire atleast one Go SDK Agent License.
## <a id='set-up-appd-nozzle'></a> Configuring AppDynamics Nozzle
1. Log in to the Ops Manager.
1. If the AppDynamics Platform Monitoring tile does not appear in the Installation Dashboard, click **Import a Product** in the left-side menu and import the AppDynamics Platform Monitoring tile.
1. Double-click the **AppDynamics Platform Monitoring for PCF** tile in the Installation Dashboard.
The Settings tab is displayed.
1. In the **Settings** tab, select **AppDynamics Nozzle Configuration**.
1. Specify the following Nozzle configuration settings and click **Save**. All the fields are mandatory. You cannot add multiple Nozzle configurations.
* **UAA token_endpoint URL**: The authentication token endpoint URL of the User Account and Authentication Service (UAA) API.
* **Doppler Traffic Controller URL**: The doppler firehose endpoint.
* Run the cf command to `cf curl /v2/info`. The UAA token_endpoint and Doppler Traffic Controller URL are the values of `token_endpoint` and `doppler_logging_endpoint` respectively
<pre class='terminal'>
$ cf curl /v2/info
{
...
"token_endpoint": "https://uaa.sys.pie-multi-az-blue.cfplatformeng.com",
...
"doppler_logging_endpoint": "wss://doppler.sys.pie-multi-az-blue.cfplatformeng.com:443",
}
</pre>
* **Username**: Username for a member account belonging to **doppler.firehose** group. This is the authorized UAA user that AppDynamics Nozzle uses to access the Loggregator. For more information, see [How to Find Credentials](https://github.com/Appdynamics/appdynamics-firehose-nozzle#how-to-find-credentials).
* **Password**: The password for the above account.
<b><i>Do one of the following to get the credentials</i></b>
* CF environments usually ship with **opentsdb-firehose-nozzle** account which already belongs to the doppler.firehose group. Use an existing account shipped with CloudFoundry, log in to the OPS Manager and select the PAS tile. Navigate to credentials > UAA > Opentsdb Nozzle Credentials. Copy the username and password.
* (or) Create a new one in the doppler.firehose group with necessary permissions. For more information, see [UAA Client](https://github.com/cf-platform-eng/firehose-nozzle#option-2-uaa-client).
* **Controller Account Name**: The name of the account in the AppDynamics Controller. Access the account name in the AppDynamics Controller UI on the Account tab under License.
* **Account Access Key**: The access key for the above Controller account. Access the account key in the AppDynamics Controller UI on the Account tab under License.
* **Controller Host**: Hostname of the AppDynamics Controller.
* **Controller Port**: The port on which the AppDynamics Controller listens for Nozzle traffic.
* **Enable Controller SSL**: Establishes secures communication with the Controller.
* **Username for Reporting Custom Dashboard**: Username of an account with custom dashboard creation permissions.
* **Password**: Password for the above Account.
### <a id='overide-nozzle-ops-manager'></a> Advanced Configuration of AppDynamics Application
This configuration is optional for 4.5.x Controllers. The Application, Tier, Node name on the Controller are created as `appd-nozzle`, `appd-nozzle-tier`, and `appd-nozzle-node` respectively on the fly.
This can be overriden by setting the below configuration. Note that the Application and Tier need not be precreated here. Just enter the names you want the metrics under.
However, for the 4.4.x Controllers, this setting is mandatory. You have to pre-create the Application and Tier on the AppDynamics Controller and enter the configuration. Note that the Tier must be `Go SDK` tier.
1. In the **Advanced Configuration (Optional for 4.5.x Controllers)** tab, specify the following settings and click **Save**.
* **Nozzle Application Name**: Enter a name to identify the Nozzle application on the Controller.
* **Nozzle Tier Name**: Enter the tier name for the Nozzle application you defined previously. This MUST be Go SDK Tier
* **Nozzle Tier ID**: Enter the component ID you identified previously.
* **Nozzle Node Name**: Enter a name for the node that corresponds to the Application Name, such as **_app-name_-node**.
1. In the Installation Dashboard, click **Apply Changes** and wait for all the changes to be applied.