AppDynamics Python Agent Linux x64 Binary Dependencies

26.3.0 verified Fri Apr 17 auth: no python

This package provides native binary dependencies specifically for the AppDynamics Python agent on Linux x64 systems. It is not intended for direct application use or import. The current version is 26.3.0, and its release cadence is tied to the main AppDynamics Python agent releases, providing underlying C extensions and other platform-specific binaries.

pip install appdynamics-bindeps-linux-x64

Common errors

error 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.

error 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.

error 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

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.")