- Check the logs
- Check if your application is instrumented
- Enabling verbose logging
- Check agent connection to the AppOptics server
- Is the service key valid?
By default the logs are sent to stderr. Common errors in the logs include missing APPOPTICS_SERVICE_KEY and not having been installed with the native library bindings built (should happen automatically on most platforms).
You can check if your application is correctly instrumented by looking for X-Trace headers, eg. using curl:
curl -i http://the-url-of-your-website
HTTP/1.1 200 OK
You will find the HTTP header
X-Trace from the HTTP response if the instrumentation is installed and enabled.
As a second diagnostic, the last two characters of
X-Trace header indicates whether the request is traced:
it is traced if the last two characters are
01 while not traced if they are
00. It is not expected that all requests will be traced; in high-traffic environments, automatic sampling kicks in.
Enable the verbose logging by define the following environment variable to 6 (Do not enable it in production environment, as it will flood your system with verbose logs):
See logging level for more information.
Review the agent log messages to see if there are any connection issues logged.
If your server is behind a firewall, please see the FAQ: My application is behind a firewall. What IP address(es) do I need to whitelist?.
The format of the API token recently changed. The new token format which is 71 characters long, may not work with previous versions of the agent (before v3.5.9). Try updating to the latest version of the agent which supports the new format.
When the APM Integrated Experience is enabled, AppOptics shares a common navigation and enhanced feature set with the other integrated experiences' products. How you navigate AppOptics and access its features may vary from these instructions. For more information, go to the APM Integrated Experience documentation.
The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.