Site24x7 Python Application Performance Monitoring

Monitor and optimize the performance of your Python application with the Site24x7 APM Insight Python agent. The agent provides you with information on the response time, throughput, database operations, and errors of your application. Keep track of these metrics over time to identify where they can be improved for better performance.

Make sure you have a Site24x7 account before you use an APM Insight agent to monitor metrics.

Requirements: Python version 3.7.0 and above.

Supported frameworks: Bottle, CherryPy, Django, Flask, and Pyramid.

Supported databases and components: PyMySQL, Psycopg2, Pymemcache, Redis, SQLite, Cassandra, Jinja2, Genshi, and Mako.

Supported HTTP libraries: http.client, httplib2, httpx, urllib, urllib3.

S247DataExporter

The S247DataExporter is an independent process dedicated for communicating application metrics and traces to the Site24x7 server.

Installation instructions for S247DataExporter:

• Run the following commands in your terminal

    wget -O "InstallDataExporter.sh" https://staticdownloads.site24x7.com/apminsight/S247DataExporter/linux/InstallDataExporter.sh
    sudo sh InstallDataExporter.sh install -lk <S247_LICENSE_KEY>
  

• If you are using proxy, add the following snippet to the command 'sudo sh InstallDataExporter.sh install -lk <S247_LICENSE_KEY>'

    -pau <Proxy auth username> -pap <Proxy auth password> -psh <Proxy server host:Proxy server port>  -psph <Boolean value whether to use HTTPS protocol for proxy> -bp <Bollean value whether to use proxy or not>
  

  *Note: By default, S247DataExporter uses 20021 as the AGENT STATUS PORT and 20022 as the AGENT DATA PORT.

If you want to run the S247DataExporter in different ports, add the below configurations to the above mentioned command.

Installation instructions for the S247 Python agent:

If you are using a virtual environment, activate the virtual environment and run the following command to install the S247 APMINSIGHT Python package into your virtual environment

    pip install apminsight

Integrate the Python agent to your application

• Using the command line
  You can use the below command for adding extra configurations:

    $ apminsight-run -lk "license_key" <apm-options> <user application execute command> 
  

Examples: If you want to configure the application name, use the below command:

  apminsight-run --apm_app_name "monitorname" <user application execute command> 

If you want to configure the directory location, use the below command:

  apminsight-run --apm_app_name "monitorname" --apm_log_dir "logs location" <user application execute command> 

• Using the code snippet

  Note: Update the configuration in the code snippet below and place it at the top of your application route file or application start file.

    from apminsight import initialize_agent
    initialize_agent({
        "appname" : "<Your application name>",
        "license_key" : "< your site24x7 license key>",
        '''change if  S247DataExporter is not running in the default ports(20021, 20022):'''
        "exporter_status_port" : "<S247DataExporter status port>",
        "exporter_data_port" : "<S247DataExporter data port>",
  
        '''If you are running S247DataExporter on a separate machine/server or as a Docker container:'''
        "exporter_host" : "<HostName/ContainerName where S247DataExporter is running>"
    })
  

  For example, for Django applications, add the code snippet at the top of the Django settings.py file. The name of your Django application will be automatically detected by your WSGI_APPLICATION in the application's settings.py.

  For other applications and frameworks, such as Flask, add the code snippet at the top of the application start file.

• Configure the agent using environment variables

• Restart your WSGI application and Perform some transactions so that the agent can collect data.
• Log in to your Site24x7 account.
• Navigate to APM Insight and click your application to view application metrics.
• You can view agent log files in the apminsightdata/logs directory, which will be present in the process-generated location.