IBM WebSphere Application Server
WebSphere Application Server (WAS) is a software framework that hosts Java-based web applications.
In addition to setting up the metrics flow, this integration also sets up a dashboard.
To see a list of the metrics for this integration, select the integration from https://github.com/influxdata/telegraf/tree/master/plugins/inputs.
IBM WebSphere Setup
Step 1. Install the Telegraf Agent
If you’ve already installed Telegraf on your server(s), you can skip to Step 2.
Log in to your product instance and follow the instructions on the Setup tab to install Telegraf and a Wavefront proxy in your environment. If a proxy is already running in your environment, you can select that proxy and the Telegraf install command connects with that proxy. Sign up for a free trial to check it out!
Step 2. Install the wasmonitor.war
on Your WebSphere Server
- Download the wasmonitor.war file.
- Deploy the
wasmonitor.war
file on your WebSphere instance. - Create a user on WebSphere, assign the Monitor role to that user, and map the application role
wavefront
to the user. - Verify the installation and configuration by accessing this URL:
http://<address>:<port>/wasmonitor/version
. The result looks similar to this:{"websphere.version": "8.5.5.12", "wasmonitor.version": "1.0"}
Step 3. Configure the Telegraf httpjson Input Plugin
First, create a file called websphere.conf
in /etc/telegraf/telegraf.d
and enter the following snippet:
[[inputs.httpjson]]
servers = ["http://10.152.24.97:9080/wasmonitor/stats"]
method = "POST"
name_override="websphere"
tag_keys = ["name", "process", "node", "cell", "mbeanIdentifier"]
[inputs.httpjson.headers]
Authorization = "Basic [Basic Authorization Base64 Sting]"
Then, replace the urls
value with your WebSphere server URL(s). Specify your servers with URL matching.
Format:
urls = ["http://<address>:<port>/wasmonitor/stats"]
Example:
urls = ["http://10.152.24.99:8080/wasmonitor/stats"]
Step 4. Generate and save a basic authorization string
WebSphere uses Basic Authorization, a Base64 encoded string, for the user and password. There are several ways to generate this string. This guide uses a public website.
- Go to https://www.base64encode.org.
- Type in the user and password created in step 2 in this format:
user:password
. - Click the Encode button.
- Copy the resulting Base64 encoded string.
- In your Telegraf
was.conf
file, replace[Basic Authorization Base64 String]
with the Base64 encoded string you just copied.
Step 5. Activate metrics
In order to get all metrics on the dashboard you need to activate these metrics on the Performance Monitoring Infrastructure
section:
- SessionManager CreateCount
- SessionManager InvalidateCount
- ThreadPool CreateCount
- ThreadPool DestroyCount
Or, you can put the PMI level to all
, and you will get more metrics the you can use in customs dashboards and alerts.
Step 6. Restart Telegraf
Run sudo service telegraf restart
to restart your Telegraf agent.