{"id":9484,"library":"appdynamics-bindeps-linux-x64","title":"AppDynamics Python Agent Linux x64 Binary Dependencies","description":"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.","status":"active","version":"26.3.0","language":"en","source_language":"en","source_url":"https://docs.appdynamics.com/display/PRO45/Install+the+Python+Agent","tags":["observability","apm","agent","binary","dependency","linux","x64"],"install":[{"cmd":"pip install appdynamics-bindeps-linux-x64","lang":"bash","label":"Install Specific Binary Dependencies"},{"cmd":"pip install appdynamics","lang":"bash","label":"Install Main AppDynamics Agent (usually pulls dependencies)"}],"dependencies":[{"reason":"This package provides native binary dependencies that are required by the main AppDynamics Python agent to function correctly on Linux x64 platforms.","package":"appdynamics","optional":false}],"imports":[],"quickstart":{"code":"# This package (appdynamics-bindeps-linux-x64) is a dependency and not directly imported.\n# To use the AppDynamics Python Agent, you would typically install 'appdynamics'\n# which usually pulls in necessary binary dependencies automatically.\n\n# Example of main AppDynamics agent initialization (requires `pip install appdynamics`):\n\nimport os\nimport appdynamics.agent\n\n# Configure Agent via Environment Variables (recommended)\n# Example:\n# os.environ['APPDYNAMICS_AGENT_APPLICATION_NAME'] = 'MyPythonApp'\n# os.environ['APPDYNAMICS_CONTROLLER_HOST_NAME'] = 'your-controller.example.com'\n# os.environ['APPDYNAMICS_CONTROLLER_PORT'] = '8090'\n# os.environ['APPDYNAMICS_AGENT_ACCOUNT_NAME'] = 'customer1'\n# os.environ['APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY'] = os.environ.get('APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY', 'YOUR_ACCESS_KEY')\n\n# Initialize the agent\nappdynamics.agent.initialize()\n\n# Your application code would go here\n# For example, instrumenting a function:\n# @appdynamics.agent.track_transaction()\n# def my_monitored_function():\n#     print(\"Executing monitored function...\")\n\nprint(\"AppDynamics agent initialized (if configured via env vars).\")\nprint(\"Remember appdynamics-bindeps-linux-x64 provides underlying native libraries.\")","lang":"python","description":"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."},"warnings":[{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"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.","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.","error":"ERROR: No matching distribution found for appdynamics-bindeps-linux-x64"},{"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.","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).","error":"ImportError: libappd.so: cannot open shared object file: No such file or directory"},{"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.","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.","error":"AppDynamics agent fails to start or report data without specific error messages during initialization."}]}