VMware

VMware vFabricTM AppInsight 1.0 Release Notes

vFabric AppInsight 1.0 | 01 November 2011 | Build 67098

Last Document Update: 12 December 2011

These release notes cover the following topics:

VMware vFabric AppInsight 1.0 Features

vFabric AppInsight is built specifically for application owners who are deploying applications on hybrid clouds and dynamic virtual environments. It enables customers to improve the service levels of their applications (availability and performance) and cost. vFabric AppInsight provides an at-a-glance health state for an application, with the ability to easily zoom in on problematic areas and to apply one or more remedial actions to all code levels, middleware and infrastructure.

AppInsight features include:

  • Integrated transaction monitoring across multiple tiers and down to code level
  • Automatic identification of business-critical transactions
  • A dashboard to view overall application health
  • The ability to monitor aggregated application costs
  • The ability to take remedial action from the management console
  • The ability to view the correlation between application infrastructure changes and performance changes
  • An out-of-the-box baseline to enable the identification of normal vs. abnormal behavior

Other VMware vFabric AppInsight 1.0 Documentation

VMware vFabric AppInsight Installation and Users Guide

System Requirements for VMware vFabric AppInsight 1.0 Installation

Before you begin the installation, make sure you have these system requirements available. You also need to have specific ports open for the AppInsight server virtual machine and network probe.

System Requirements

You require the following disk space and memory for the AppInsight server virtual machine and the network probe:

  • AppInsight Server virtual machine: 50 GB disk space; 8 GB memory*, 4 vCPU**
     * In an environment of more than 300 application components, increase the memory of the AppInsight Server virtual machine to 12 GB.
    ** In an environment of less that 30 application components, 2vCPU are sufficient.
  • Network probe: 6 GB disk space; 0.5GB memory, 2 vCPU

In addition, You require the following open ports for the AppInsight server virtual machine and the network probe:

  • AppInsight Server virtual machine
    • TCP Port 80, 8443 - For the AppInsight user interface connection from the external client.
    • TCP Port 1194 - For the network probe connection to this AppInsight server virtual machine
    • TCP Port 5671 - (When multiple BCI collectors are installed) For the connection to the AppInsight message queue
    • TCP Port 21234 - (Optional) BCI agent connection with the AppInsight server
  • Network Probe
    • TCP Port 1194 - For the connection to the AppInsight server virtual machine
    • UDP Port 123 - For the NTP on the AppInsight server virtual machine
    • TCP Port 5671 - (When multiple BCI collectors are installed) For the connection to the AppInsight message queue

Supported Screen Resolution

AppInsight is supported on screen resolutions of 1024 x 768, and higher.

VMware recommends that you view vFabric AppInsight in full screen mode.

Web Interface Support

Supported Web browsers:

  • Microsoft Internet Explorer 8, 9
  • Google Chrome
  • Mozilla FireFox 3.6
  • Safari 4.0.4

Installation Notes

Refer to the VMware vFabric AppInsight Installation and Users Guide` for installation instructions.

After you have completed AppInsight 1.0 installation, download and run modifyMaxAge.sh to apply the perpetual password period patch.

Known Issues with VMware vFabric AppInsight 1.0

The following known issues affect the AppInsight 1.0 release:

Installation

  • JBoss is not supported in AppInsight 1.0.
  • If there is a mismatch between the name of a vSwitch and the name of the AppInsight port group on the vSwitch, network probe deployment fails.
  • If you use static IP addresses, VMware recommends that you use only one DNS server during installation. If you require more than one DNS server, add it manually to the /etc/resolv.conf file.

User Interface

  • Incorrect colors might appear for widgets in the dashboard. Click Refresh to correct the widgets' colors.
  • VMware recommends that you wait until a view has finished loading before you switch to another view.
  • When you add or remove a metric to a configurable chart, the colors of all existing lines change.
  • The Most Used Application widget in the dashboard appears disabled when you have not actived the Usage KPI.
  • In Internet Explorer, a Certificate Error message appears.
  • The time picker does not show the entire selected time period. For example, if you select the 10 minute resolution, the time picker might show 10:41:30-10:50:30, which is only nine minutes.
  • Occasionally, "Application Infrastructure KPI" appears in the user interface instead of "Middleware KPI".
  • The name of a virtual machine that is powered off does not appear in the user interface. A different IP-based platform name appears.
  • Occasionally, hints do not show content. Refresh the page to show the content.

KPIs

  • In the Components Health KPI, values that you set for the tolerate threshold are not effective.
  • The Application Infrastructure Over Time KPI does not show the correct chart when a component is selected.

Adapter Management

    If extra spaces are included in the Hostname text box when registering an adapter, AppInsight will not connect with the adapter.

vCenter Integration

    In the case in which duplicate IP addresses exist in the vSphere Client, which generally only occurs with internal IP addresses, AppInsight might display an incorrect virtual machine name.

BCI Agent

  • You cannot download the BCI Agent installation ZIP file or server snapshot from the AppInsight server using Internet Explorer 8. Download the file using one of the other supported browsers.
  • Database transactions, other than JDBC, are not recognized by the BCI adapter.
  • Installation of the BCI agent on a Tomcat application server that is installed as a service on Windows operating systems is not supported.

vFabric Hyperic Integration

    Data that is retrieved from Hyperic might be inaccurate if the Hyperic time is not synchronized with APM Server time.

vCenter Chargeback

    If you unregister the Chargeback adapter from AppInsight, the application cost continues to appear in the General Details of the application.

vCenter Orchestrator

    If a vCO is configured with multiple vCenter Servers and an action is performed on a virtual machine that uses the same name in multiple vCenter Servers, the action is not performed, to prevent errors. A message appears in the user interface log.

Topology

  • Correlations between network components that use a transparent proxy are not available.
  • When a server has two IP addresses, one for incoming traffic and another for outgoing traffic, hints related to outgoing traffic are not available.
  • If there is a correlation between components in the left-most tier of an application's topology, redundant transactions are created.
  • From time to time, when metrics are added or removed from vCenter or Hyperic, the change does not appear in the topology in AppInsight. Try restarting AppInsight to resolve the issue.
  • If you attempt to add a cloned virtual machine with a static IP address to the topology of an AppInsight application, the virtual machine will not be added.
  • Servers that use a range of ports are not supported. In AppInsight, the server is identified as a single application component.
  • When you add a new tier to the topology as the left-most tier, all existing transaction data is deleted. New transaction data is displayed as it is detected by AppInsight on the new left-most tier.

Server

  • In the event that you are unable to manually add WebSphere SSL certificates, contact VMware Technical Support for assistance.
  • When the host clock for a probe is not synchronized with the clock on the server host, probe deployment will fail until the time on the probe host matches the time when the server was first installed on the server host.
  • In applications that are built from the same page template, for example Wiki, transactions are not learned by AppInsight.

Monitoring

  • AppInsight does not recognize Oracle errors. In such cases, "0% errors" appears instead of the correct error rate.
  • When you create a new application component group, it might take up to 25 minutes before monitored data appears in the application's topology.
  • When you create a new application component group, the monitored data is not correct until each of the components in group have existed for the entire time resolution. For example, if an application group has three components that are being monitored in a time resolution of one hour, but one of the components was only created 45 minutes earlier, the displayed application component group data is only accurate after one hour and 15 minutes (after the most recently created component is in existence for one hour.)
  • Changes that are made in external data sources, (vCenter, Hyperic, Chargeback and Orchestrator), might take up to 23 hours before monitored data is available.

User Management

  • A user who does not have Write permissions can add, edit and delete an application's alerts.
  • A user who has Write permissions for some applications, can create or edit a single "all applications" rule.
  • Application owners can view alerts for applications for which they do not have Application Owner permissions.