{"id":9485,"library":"appdynamics-proxysupport-linux-x64","title":"AppDynamics Proxy Support for Linux x64","description":"This package provides platform-specific native (C/C++) extensions for proxy support and network communication for the AppDynamics Python Agent. It is an internal runtime dependency automatically managed by the main `appdynamics` agent package and is not intended for direct user interaction or import. The current version is 11.86.0 and it is released in conjunction with the main AppDynamics Python Agent.","status":"active","version":"11.86.0","language":"en","source_language":"en","source_url":"https://github.com/Appdynamics/appdynamics-agent-py","tags":["appdynamics","apm","monitoring","proxy","native","linux","x64"],"install":[{"cmd":"pip install appdynamics-proxysupport-linux-x64","lang":"bash","label":"Direct Installation (Rare for Users)"}],"dependencies":[{"reason":"This package is a runtime dependency providing native proxy support for the main AppDynamics Python Agent. It is loaded internally by the agent.","package":"appdynamics","optional":false}],"imports":[{"note":"The `appdynamics-proxysupport-linux-x64` package is an internal runtime dependency used by the main `appdynamics` agent. User code should only import `appdynamics.agent`.","symbol":"(None)","correct":"This package does not expose public symbols for direct import."}],"quickstart":{"code":"import os\nimport appdynamics.agent\nfrom appdynamics.agent import initialize\n\n# AppDynamics Agent Initialization (typical setup)\n# Ensure these environment variables are set in your deployment environment\n# e.g., in a Dockerfile, k8s manifest, or shell script\n# AD_CONTROLLER_HOST: Your AppDynamics Controller Hostname\n# AD_CONTROLLER_PORT: Your AppDynamics Controller Port (e.g., 8090)\n# AD_AGENT_ACCOUNT_NAME: Your AppDynamics Account Name\n# AD_AGENT_ACCOUNT_ACCESS_KEY: Your AppDynamics Account Access Key\n# AD_APPLICATION_NAME: Your Application Name\n# AD_TIER_NAME: Your Tier Name\n# AD_NODE_NAME: Your Node Name\n\ncontroller_host = os.environ.get('AD_CONTROLLER_HOST', 'localhost')\ncontroller_port = int(os.environ.get('AD_CONTROLLER_PORT', '8090'))\naccount_name = os.environ.get('AD_AGENT_ACCOUNT_NAME', 'customer1')\naccount_access_key = os.environ.get('AD_AGENT_ACCOUNT_ACCESS_KEY', '')\napplication_name = os.environ.get('AD_APPLICATION_NAME', 'MyPythonApp')\ntier_name = os.environ.get('AD_TIER_NAME', 'WebTier')\nnode_name = os.environ.get('AD_NODE_NAME', 'Node1')\n\ntry:\n    initialize(\n        controller={'host': controller_host, 'port': controller_port, 'ssl': False},\n        account={'name': account_name, 'access_key': account_access_key},\n        application={'name': application_name, 'tier_name': tier_name, 'node_name': node_name},\n        # For proxy settings, these would usually be set via environment variables as well\n        # e.g., AD_PROXY_HOST, AD_PROXY_PORT, etc.\n        # The appdynamics-proxysupport-linux-x64 package provides the native\n        # libraries that handle these proxy connections internally.\n        log={'log_level': 'INFO', 'output_path': 'stdout'},\n        auto_instrument=True # Usually enabled for web frameworks\n    )\n    print(\"AppDynamics Agent initialized successfully.\")\nexcept Exception as e:\n    print(f\"Failed to initialize AppDynamics Agent: {e}\")\n    print(\"Ensure environment variables are set correctly and controller is reachable.\")\n\n# Your application code would go here\ndef my_application_function():\n    print(\"Application function running...\")\n\nif __name__ == \"__main__\":\n    my_application_function()","lang":"python","description":"This package is an internal dependency of the AppDynamics Python Agent. The quickstart demonstrates the typical initialization of the *main* AppDynamics agent, which transparently utilizes this proxy support package for its network communications, especially when a proxy is configured (often via environment variables like `AD_PROXY_HOST`). Users generally install `appdynamics` directly, which then pulls in the correct platform-specific proxy support package."},"warnings":[{"fix":"Always install the main `appdynamics` package (`pip install appdynamics`). It will automatically select and install the correct `appdynamics-proxysupport-<platform>` package for your operating system and architecture.","message":"This package (`appdynamics-proxysupport-linux-x64`) is a platform-specific binary dependency. Installing it manually on a non-Linux x64 system will not work and can cause errors in the main AppDynamics agent.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure that the `appdynamics-proxysupport-linux-x64` package's version is compatible with your installed `appdynamics` agent version. It's best practice to let `pip install appdynamics` manage this dependency automatically.","message":"Version mismatch between `appdynamics-proxysupport-linux-x64` and the main `appdynamics` agent. Installing incompatible versions manually can lead to runtime errors, agent failures, or incorrect data reporting.","severity":"breaking","affected_versions":"All versions"},{"fix":"Verify the system environment meets the AppDynamics agent's prerequisites, especially for native libraries. Check agent logs for specific errors during native library loading. Consider using a compatible Linux distribution or a containerized environment with necessary libraries.","message":"Python agent startup fails with warnings/errors about missing or uncallable native libraries when proxy support is enabled or required. This can happen if the `appdynamics-proxysupport-linux-x64` package's native binary cannot be loaded by the Python interpreter, often due to missing shared library dependencies (e.g., GLIBC versions).","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":"Reinstall the main `appdynamics` agent to ensure all platform-specific dependencies are correctly fetched and installed: `pip install --upgrade --force-reinstall appdynamics`. Ensure your environment (OS/architecture) corresponds to `linux-x64`.","cause":"The main `appdynamics` agent could not locate or load its internal `proxysupport` components, possibly due to a corrupted installation or a platform mismatch.","error":"ModuleNotFoundError: No module named 'appdynamics_proxysupport_linux_x64'"},{"fix":"Check the AppDynamics agent logs for the exact error message (e.g., `libstdc++.so.6` not found). Ensure your system's `glibc` version meets the agent's requirements (typically a reasonably modern Linux). For containerized environments, ensure the base image contains necessary runtime libraries.","cause":"The native library provided by `appdynamics-proxysupport-linux-x64` failed to load, often due to incompatible glibc versions, missing runtime dependencies on the OS, or permissions issues.","error":"Failed to load AppDynamics native library: [error message related to shared object]"},{"fix":"Verify the proxy host, port, and authentication details in your AppDynamics agent configuration (usually environment variables like `AD_PROXY_HOST`, `AD_PROXY_PORT`, `AD_PROXY_USER`, `AD_PROXY_PASSWORD`). Ensure network connectivity from the agent host to the proxy server.","cause":"The native proxy support library attempted to connect to a proxy server but failed, potentially due to incorrect proxy configuration, network issues, or an unreachable proxy.","error":"Proxy connection failed: [error message]"}]}