Monitoring TIBCO ActiveSpaces®
The TIBCO ActiveSpaces® sensor is automatically deployed and installed after you install the Instana agent.
Supported TIBCO ActiveSpaces® version
Instana now supports metrics and configuration data for TIBCO ActiveSpaces® 4.9.0 Enterprise Edition.
Prerequisites
- Ensure that the TIBCO ActiveSpaces® 4.9.0 Enterprise Edition with monitoring is enabled.
- Ensure that the data grid is connected to the TIBCO FTL 6.10.1 realm server.
Configuration
Configuring TIBCO ActiveSpaces
Instana agent uses the following configuration to connect to the TIBCO FTL realm server. You can update the configuration in the agent configuration file (<agent_install_dir>/etc/instana/configuration.yaml):
# Tibco ActiveSpaces FTL server configurations
com.instana.plugin.tibcoas:
applicationName: '' # application name for ftl server connection. Default is: 'default'
user: '' # username for the ftl server.
password: '' # password for the ftl server.
trustFile: '/path/to/ftl-trust.pem' # path to ftl server trust file
libPath: '/path/to/lib' # path to ftl native libraries
poll_rate: 1 # Default poll rate is 1 second
Providing driver
When the Instana agent begins and discovers a TIBCO ActiveSpaces without a driver, the Instana agent logs the following message:
Cannot monitor Tibco Activespaces without tibftl-<version>.jar For licensing reasons they cannot be provided by Instana and need to be manually obtained and added to the agent
You can find the drivers in the <tibco ftl installation dir>/lib/tibftl.jar file.
To add the drivers to the Instana agent, add them to the following location <agent_install_dir>/system/com/tibco/tibftl/4.9.0/tibftl-4.9.0.jar.
Viewing metrics
To view the metrics, do the following steps:
-
From the navigation menu in the Instana UI, select Infrastructure.
-
On the infrastructure map, select your TIBCO ActiveSpaces monitored host, and click the TIBCO ActiveSpaces node slice.
-
To display the TIBCO ActiveSpaces node dashboard, click Open Dashboard.
The dashboard includes all the metrics that you selected for the TIBCO ActiveSpaces node.
TIBCO ActiveSpaces node
You can view the following configuration data and metrics of the TIBCO ActiveSpaces node.
Configuration data
The following table lists the configuration details of the TIBCO ActiveSpaces node:
| Node details | Description |
|---|---|
| Process ID | PID of the node process |
| Node Name | Name of the node |
| Grid Name | Name of the grid |
| Copyset Name | Name of the copyset |
| Version | Version of TIBCO ActiveSpaces |
| Node Type | Type of the node (Primary or Secondary) |
| Data Directory | The nodes store the data that applications put in the data grid in the data directory |
Node metrics
The following table lists the metric details of the TIBCO ActiveSpaces node:
| Node metrics | Description |
|---|---|
| Live Data Size | The live data size on a node for a specific process |
| Completed operations | The number of completed operations on a node for a specific process |
| Failed operations | The number of failed operations on a node for a specific process |
| Pending Global Requests | The number of pending global requests on a node for a specific process |
| Disk Write Rate | The number of write operations on kvstore on a node for a specific process |
| Number of Listeners | The number of listeners on a node for a specific process |
| Concurrent Active queries | The number of concurrent queries that are active on a node for a specific process |
| Concurrent Global queries | The number of globally consistent queries on a node for a specific process |
| Put | The number of put operations on a node for a specific process |
| Get | The number of get operations on a node for a specific process |
| Delete | The number of delete operations on a node for a specific process |
| Update | The number of update operations on a node for a specific process |
| Begin | The number of transactions that are started on a node for a specific process |
| Commit | The number of transaction commit operations on a node for a specific process |
| Rollback | The number of transaction rollback operations on a node for a specific process |
| Rows Scanned count | The number of rows that are scanned on a node for a specific process |
| Rows Deleted count | The number of rows that are deleted on a node for a specific process |
| DR Put | The number of DR put operations on a node for a specific process |
| DR Delete | The number of DR delete operations on a node for a specific process |
| Reindexed Rows Count | The number of reindexed rows on a node for a specific process. |
| Reclaimed Keys Count | The number of keys that are deleted on a node for a specific process |
| SQL Insert | The number of SQL insert operations on a node for a specific process |
| SQL Delete | The number of SQL delete operations on a node for a specific process |
| SQL Update | The number of SQL update operations on a node for a specific process |
TIBCO ActiveSpaces proxy
You can view the following configuration data and metrics of the TIBCO ActiveSpaces proxy.
Configuration data
The following table lists the configuration details of the TIBCO ActiveSpaces proxy:
| Proxy details | Description |
|---|---|
| Process ID | PID of the proxy process |
| Proxy Name | Name of the proxy |
| Grid Name | Name of the grid |
| Version | Version of TIBCO ActiveSpaces |
Proxy metrics
The following table lists the metric details of the TIBCO ActiveSpaces proxy:
| Proxy metrics | Description |
|---|---|
| Put | The number of put operations that are performed through a proxy for a specific process |
| Get | The number of get operations that are performed through a proxy for a specific process |
| Remove | The number of remove operations that are performed through a proxy for a specific process |
| Begin | The number of transactions that are initiated through a specific proxy process |
| Commit | The number of transactions that are committed through a proxy for a specific process |
| Rollback | The number of transactions that are rolled back through a proxy for a specific process |
| Active Statements Delete count | The number of active statements that are deleted through a proxy for a specific process |
| Active Statements Insert count | The number of active statements that are inserted through a proxy for a specific process |
| Active Statements Update count | The number of active statements that are updated through a proxy for a specific process |
| Active Statements Select count | The number of active statements that are selected through a proxy for a specific process |
| Active ExecuteUpdate Delete Requests count | The number of active Data Manipulation Language (DML) delete requests that are sent through a proxy for a specific process |
| Active ExecuteUpdate Insert Requests count | The number of active DML insert requests that are sent through a proxy for a specific process |
| Active ExecuteUpdate Update Requests count | The number of active DML update requests that are sent through a proxy for a specific process |
Tibco ActiveSpaces data grid
You can view the following configuration data and metrics of the TIBCO ActiveSpaces data grid.
Configuration data
The following table lists the configuration details of the TIBCO ActiveSpaces node:
| Node details | Description |
|---|---|
| Grid Name | Name of the grid |
Data grid metrics
The following table lists the metric details of the TIBCO ActiveSpaces data grid:
| Data grid metrics | Description |
|---|---|
| Completed operations | The number of completed operations on the data grid |
| Failed operations | The number of failed operations on the data grid |
| Number of Listeners | The number of listeners on the data grid |
| Concurrent Active queries | The number of concurrent queries that are active on the data grid |
| Concurrent Global queries | The number of globally consistent queries on the data grid |
| Put | The number of put operations on the data grid |
| Get | The number of get operations on the data grid |
| Delete | The number of delete operations on the data grid |
| Update | The number of update operations on the data grid |
| Begin | The number of transactions that are started on the data grid |
| Commit | The number of transaction commit operations on the data grid |
| Rollback | The number of transaction rollback operations on the data grid |
| Rows Scanned count | The number of rows that are scanned on the data grid |
| Rows Deleted count | The number of rows that are deleted on the data grid |
| Active Statements Delete count | The number of active statements that are deleted on the data grid |
| Active Statements Insert count | The number of active statements that are inserted on the data grid |
| Active Statements Update count | The number of active statements that are updated on the data grid |
| Active Statements Select count | The number of active statements that are selected on the data grid |
| Active ExecuteUpdate Delete Requests count | The number of active DML delete requests on the data grid |
| Active ExecuteUpdate Insert Requests count | The number of active DML insert requests on the data grid |
| Active ExecuteUpdate Update Requests count | The number of active DML update requests on the data grid |
Troubleshooting
Use these troubleshooting entries to help resolve problems that are related to monitoring the TIBCO ActiveSpaces® applications. An error message with the stated issue type and a brief explanation on what went wrong is displayed on the TIBCO ActiveSpaces dashboard in the Instana UI.
Tibco ActiveSpaces® FTL connect error
You can view the following error message on the TIBCO ActiveSpaces dashboard when the TIBCO ActiveSpaces sensor does not connect to TIBCO FTL.
Monitoring issue type: tibcoas_ftl_connect_error
To resolve the error, verify the following details:
-
The TIBCO FTL server is running and reachable.
-
The connection parameters such as
applicationName,user,password,trustFile, andlibPathare configured in the monitoring agent.
You must validate the credentials.