-
Notifications
You must be signed in to change notification settings - Fork 8
/
deploy-metrics.html.md.erb
158 lines (91 loc) · 8.23 KB
/
deploy-metrics.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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
---
title: Deploying JMX Bridge
owner: PCF Metrics
---
<strong><%= modified_date %></strong>
The JMX Bridge tool is a JMX extension for Elastic Runtime. Follow the instructions below to deploy JMX Bridge using the [Pivotal Cloud Foundry](https://network.pivotal.io/products/pcf-metrics) (PCF) Operations Manager.
## <a id='import'></a> Step 1: Install the JMX Bridge Tile
<p class="note"><strong>Note</strong>: To use the Firehose Nozzle, you <strong>must</strong> install <a href="https://network.pivotal.io/products/elastic-runtime">Elastic Runtime</a> <strong>before</strong> installing JMX Bridge. JMX Bridge requires the components to be installed in this order.</p>
1. [Download JMX Bridge](https://network.pivotal.io/products/ops-metrics).
1. Import JMX Bridge into Ops Manager by following the instructions for [Adding and Importing Products](https://docs.pivotal.io/pivotalcf/1-7/customizing/add-delete.html#add-import).
1. On the Installation Dashboard, click the **JMX Bridge** tile.
<%= image_tag("images/metrics-tile.png") %>
The orange bar on the **JMX Bridge** tile indicates that the product requires configuration.
## <a id='config-az'></a> Step 2: Assign Availability Zones and Networks
1. Select **Assign AZs and Networks**. This section shows the [Availability Zones that you Create](https://docs.pivotal.io/pivotalcf/1-7/customizing/vsphere-config.html#create-az) when configuring the BOSH Director.
1. (**vSphere and Amazon Web Services Only**) Select an Availability Zone under **Place singleton jobs in**. This Availability Zone is where Ops Manager runs Metrics jobs that only have a single instance.
1. (**vSphere and Amazon Web Services Only**) Select one or more Availability Zones under **Balance other jobs in**. Ops Manager balances Metrics jobs with more than one instance across the Availability Zones that you specify.
<%= image_tag("images/assign-az.png") %>
1. Select a Network from the drop down menu.
<p class='note'><strong>Note:</strong> JMX Bridge uses the default Assigned Network if you do not select a different network.</p>
1. Click **Save**.
<p class="note"><strong>Note:</strong> When you save this form, a verification error displays. You can ignore this error. It only appears because the PCF security group blocks ICMP.</p>
<%= image_tag("images/er-network-error.png") %>
## <a id='config-jmx-provider'></a> Step 3: Configure JMX Provider
1. Select **JMX Provider**.
1. Enter a new username and password into the **JMX Provider credentials** username and password fields.
1. Record these credentials. You use these to connect JMX clients to the JMX Provider.
## <a id='config-nat'></a> (Optional) Step 4: Enable NAT Support
1. Select the **Enable** radio button. NAT support is disabled by default. Enabling NAT support allows you to set the NAT IP as the host IP. By default, the internal IP address of the JMX Provider VM is set as the host IP.
1. Enter the NAT IP as the External IP address in the form `0.0.0.0`
<%= image_tag("images/jmxbridge-enable-nat-support.png") %>
1. If you have enabled or disabled `NAT Support`, click **Save**.
<p class="note"><strong>Note:</strong> To connect to the JMX Provider after install, you <strong>must</strong> use the specified IP address. The IP address displayed in the <code>Status</code> tab always reflects the internal IP address of the JMX Provider VM, not the external IP address.</p>
## <a id='config-security-logging'></a> (Optional) Step 5: Enable Security Logging
1. Select the **Enable Security Logging** checkbox. Access to the JMX endpoint is logged to stdout by default. You can enable security logging in the JMX Bridge tile configuration by selecting this checkbox, or disable it by deselecting this checkbox. Security logging is enabled by default.
<%= image_tag("images/jmxbridge-enable-security-logging.png") %>
1. If you made changes to Security Logging, click **Save**.
<p class="note"><strong>Note:</strong> Related log output is made available by initiating a JMX Provider logs download from the JMX Bridge tile configuration status tab, then fetching the download from the logs tab.</p>
## <a id='config-ssl'></a>(Optional) Step 6: Configure SSL ##
1. Select the **Enable SSL** checkbox. If you enable SSL, JMX clients are forced to use SSL to connect to the JMX Provider.
<%= image_tag("images/ops-metrics-jmx-ssl.png") %>
If you select the **Enable SSL** checkbox, you must also provide an SSL
certificate and private key.
There are two ways to provide an SSL certificate and private key:
* If you are using a signed certificate, paste an X.509 certificate in the
**Certificate PEM** field and a PKCS#1 private key in the **Private Key**
field.
* If you want to use SSL but do not want to use a signed certificate, you
must perform the following actions:
1. Generate a self-signed certificate on the server.
1. Import the self-signed certificate to a trust store on the client.
1. Start jConsole, or another monitoring tool, with the trust store.
For more information, see [Using SSL with a Self-Signed Certificate](./self-signed-ssl.html).
<%= image_tag("images/ops-metrics-jmx-cert.png") %>
1. Click **Save**.
## <a id='errands'></a>(Optional) Step 7: Configure Errands ##
<p>Errands are scripts that Ops Manager runs to automate tasks.
By default, Ops Manager runs the post-install errands listed below when you deploy PCF JMX Bridge. However, you can prevent a specific post-install errand from running by deselecting its checkbox on the Errands page.</p>
<%= image_tag("images/jmx-errands.png") %>
* Select **Smoke tests for JMX Bridge** to cause the JMX Bridge to verify the following:
* If the Firehose Nozzle is enabled, JMX Bridge verifies that the Nozzle is receiving metrics and that the product is not a slow consumer
* If <a href="#config-ip">BOSH Metrics</a> are enabled, JMX Bridge verifies that the product is receiving appropriate health metrics
<p class="note"><strong>Note</strong>: If errors occur during the install due to smoke tests, refer to the <a href="./troubleshooting-uninstall-metrics.html#smoke-tests">troubleshooting documentation</a> for more information.</p>
## <a id='resource-config'></a>(Optional) Step 8: Resource Configuration ##
<p class="note"><strong>Note</strong>: The Firehose Nozzle is enabled by default and requires <a href="https://network.pivotal.io/products/elastic-runtime">Elastic Runtime</a>.</p>
To disable the Firehose Nozzle or stop receiving <a href="https://network.pivotal.io/products/elastic-runtime">Elastic Runtime</a> (including Diego) metrics, modify the instance count of the **OpenTSDB Firehose Nozzle** from `1` to `0`.
## <a id='apply'></a>Step 9: Apply Changes ##
1. Navigate to the PCF Ops Manager Installation Dashboard.
1. In the Pending Changes view, click **Apply Changes** to install JMX Bridge.
<%= image_tag("images/ops-metrics-pending-changes.png") %>
After installation completes, a message appears stating that the changes have been applied.
## <a id='get-ip'></a>Step 10: Find the IP Address of the JMX Provider ##
1. Click **Return to Product Dashboard**.
1. Click the **JMX Bridge** tile and select the **Status** tab.
<%= image_tag("images/ops-metrics-jmx-ips.png") %>
1. Record the IP address of the **JMX Provider**.
<p class="note"><strong>Note</strong>: After installation, your JMX client connects to this IP address at port 44444 using the credentials that you supplied. Also ensure that TCP port 44445 is open.</p>
## <a id='config-ip'></a>Step 11: Configure the Metrics IP Address ##
1. Return to the **Installation Dashboard**.
Click the **BOSH Director** tile and select **Director Config**.
<%= image_tag("images/ops-metrics-director-ip.png") %>
1. In the **Metrics IP Address** field, enter the IP address of the JMX
Provider.
Click **Save**.
## <a id='complete'></a>Step 12: Complete Installation ##
1. In the Pending Changes view, click **Apply Changes**.
<%= image_tag("images/ops-metrics-pending-changes.png") %>
When complete, a message appears stating that the changes have been applied.
<br>
1. Click **Return to Product Dashboard**. JMX Bridge is now installed and configured.
After installation and configuration, metrics for Cloud Foundry components automatically report to the JMX endpoint.