AppDynamics Python Agent Linux x64 Binary Dependencies

Common errors

• ERROR: No matching distribution found for appdynamics-bindeps-linux-x64

  cause This error typically occurs when pip cannot find a suitable package for your operating system or Python version. Common causes include attempting to install on a non-Linux x64 platform or an unsupported Python version.
  fix Verify that your environment is Linux x64 and that your Python version is compatible with the AppDynamics agent. If necessary, check the AppDynamics documentation for supported Python versions and manual installation steps for specific platforms.

• ImportError: libappd.so: cannot open shared object file: No such file or directory

  cause This error indicates that the AppDynamics Python agent cannot locate its native libraries (provided by `appdynamics-bindeps-linux-x64`). This can happen if the `bindeps` package failed to install correctly, was corrupted, or if environment variables like `LD_LIBRARY_PATH` are incorrectly configured (though less common for pip-installed packages).
  fix Reinstall both `appdynamics` and `appdynamics-bindeps-linux-x64`. Ensure there are no errors during installation. Check file permissions in the Python site-packages directory. If running in a container, verify the image includes necessary base libraries.

• AppDynamics agent fails to start or report data without specific error messages during initialization.

  cause While not a direct error message from `appdynamics-bindeps-linux-x64`, a silently failing agent can be a symptom of underlying native library issues if `bindeps` is not correctly installed or compatible. The Python agent might partially load but fail in its C extension parts.
  fix Ensure `appdynamics-bindeps-linux-x64` is installed correctly for your platform. Check the AppDynamics agent logs (configured via `APPDYNAMICS_LOG_FILE` or similar) for more detailed error messages related to native library loading or initialization failures. Verify full system compatibility with AppDynamics requirements.

Warnings

• gotcha This package is platform-specific and only intended for Linux x64 systems. Installing it on other operating systems (e.g., Windows, macOS) or architectures (e.g., ARM) will likely result in installation errors or a non-functional AppDynamics agent.
  Fix: Ensure you are installing this package only on supported Linux x64 environments. For other platforms, refer to AppDynamics documentation for appropriate dependency packages or agent installation instructions.
• gotcha This package is a binary dependency for the main `appdynamics` Python agent and is not meant for direct application import or interaction. Users should typically install `appdynamics`, which usually handles the installation of its required binary dependencies like `appdynamics-bindeps-linux-x64` automatically.
  Fix: Focus on installing and configuring the `appdynamics` package. Only install `appdynamics-bindeps-linux-x64` directly if specifically instructed by AppDynamics support or advanced deployment scenarios where automatic dependency resolution is bypassed.
• gotcha Mismatch between `appdynamics-bindeps-linux-x64` version and the `appdynamics` agent version can lead to runtime errors or agent instability, as native libraries might not be compatible.
  Fix: Ensure that the versions of `appdynamics` and any directly installed `appdynamics-bindeps-linux-x64` are compatible. Generally, installing `appdynamics` alone is sufficient, as `pip` will manage the compatible binary dependency automatically.

Install

• pip install appdynamics-bindeps-linux-x64 Install Specific Binary Dependencies
• pip install appdynamics Install Main AppDynamics Agent (usually pulls dependencies)

Quickstart

The `appdynamics-bindeps-linux-x64` package is an underlying binary dependency and does not expose Python symbols for direct import or a standalone quickstart. The actual AppDynamics Python Agent is initialized via the `appdynamics` package, typically configured using environment variables. This quickstart demonstrates the general initialization pattern for the AppDynamics Python agent, which relies on the binary dependencies provided by this package.

# This package (appdynamics-bindeps-linux-x64) is a dependency and not directly imported.
# To use the AppDynamics Python Agent, you would typically install 'appdynamics'
# which usually pulls in necessary binary dependencies automatically.

# Example of main AppDynamics agent initialization (requires `pip install appdynamics`):

import os
import appdynamics.agent

# Configure Agent via Environment Variables (recommended)
# Example:
# os.environ['APPDYNAMICS_AGENT_APPLICATION_NAME'] = 'MyPythonApp'
# os.environ['APPDYNAMICS_CONTROLLER_HOST_NAME'] = 'your-controller.example.com'
# os.environ['APPDYNAMICS_CONTROLLER_PORT'] = '8090'
# os.environ['APPDYNAMICS_AGENT_ACCOUNT_NAME'] = 'customer1'
# os.environ['APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY'] = os.environ.get('APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY', 'YOUR_ACCESS_KEY')

# Initialize the agent
appdynamics.agent.initialize()

# Your application code would go here
# For example, instrumenting a function:
# @appdynamics.agent.track_transaction()
# def my_monitored_function():
#     print("Executing monitored function...")

print("AppDynamics agent initialized (if configured via env vars).")
print("Remember appdynamics-bindeps-linux-x64 provides underlying native libraries.")