次の項では、Python エージェントのプレイブックの使用例を示します。

Python エージェントのインストール

Example 1：以下の機能を備えた Python エージェントのインストールに使用される Ansible® ロール：

  • Linux（Debian、Alpine、および RedHat）への Python エージェントのインストール
  • 既存のインストールが検出された場合のバックアップの作成
---
- hosts: all
  tasks:
    - name: Include variables for the controller settings
      # Include all yaml files under the vars directory
      include_vars:
        dir: vars
        extensions:
          - 'yaml'
          - 'yml'

    - include_role:
        name: appdynamics.agents.python
      vars:
        agent_version: 22.10.0.5500.0
        # possible value:
        #          - latest: Latest version 
        #          - 22.10.0.5500.0: Any Specific version number
        agent_type: python
        agent_action: upgrade
        # possible value:
        #          - upgrade: upgrade currently installed agent to agent_version 
        #          - install: install agent_version
        #          - rollback: rollback to previous backup if any
        #          - uninstall: uninstall agent
        # Python specific Args
        install_env: default # [default - (main python path taken automatically), virtualenv - (virtualenv path need to be provided)]
        # possible value:
        #          - default: install agent in global python
        #          - virtualenv: install agent  to specific virtualenv
        virtualenv_path: /home/ansible/venv
        # possible value:
        #          - /home/ansible/venv: virtualenv path
        #          - None
        install_agent_from: appd-portal
        # possible value:
        #          - pypi: Downlaod agent from PYPI
        #          - appd-portal: Download agent from AppD portal
YML

Example 2：Python エージェントでサンプルアプリケーションを起動するための Ansible ロール：

---
- hosts: all
  tasks:
    - name: Include variables for the controller settings
      # Include all yaml files under the vars directory
      include_vars:
        dir: vars
        extensions:
          - 'yaml'
          - 'yml'

    - include_role:
        name: appdynamics.agents.python
    
    - name: Start Sample Python app
      shell: "nohup pyagent run -c /opt/appdynamics/python-agent/appd.cfg python3 /home/ubuntu/app.py &"
      async: 100
      poll: 0
      register: status
      failed_when: "'FAILED' in status.stdout"

Config path and the application path has to be changed accordingly.
YML

Python エージェントの変数

変数説明デフォルト使用可能な値必須

agent_config_path

エージェント設定データが含まれている、手動で作成した構成ファイルの絶対パス（ファイルパスを含む）を指定します。

なし。

agent_destination_directory

なし
analytics_host分析エージェントのホスト名。localhost
なし
analytics_port分析エージェントのポート。9090
なし
analytics_ssl分析エージェントとの SSL 通信を有効にするには、ON に設定します。OFF
なし
analytics_ca_file分析エージェントの証明書に署名した CA の証明書。

なし
eum_disable_cookieON に設定すると、エージェントが EUM 相関データを WSGI レスポンスヘッダーに追加しません。OFFOFF, ONなし
eum_user_agent_allowlist指定すると、EUM 相関データヘッダーとして追加されたユーザーエージェントのデフォルト許可リストを上書きします。代替ユーザーエージェントをカンマ区切りリストとして指定するには、この設定を使用します。すべてのユーザエージェントを許可するには、「*」を使用します。Mozilla、Opera、WebKit、Nokia
なし
install_agent_fromPYPI または AppDynamics ダウンロードポータルからのエージェントのインストールpypipypi, appd-portalあり
install_envAppDynamics エージェントをインストールする Python 環境（グローバルまたは仮想環境）defaultdefault, virtualenvあり
log_levelプロキシとエージェントのログを書き込むディレクトリwarningwarning, debug, infoなし
log_debuggingエージェントのログレベル。
off, onなし
log_dirデバッグレベルのログを書き込むディレクトリ/tmp/appd/logs
なし
node_reuseノード名を再利用します。-true、 falseなし
node_reuse_prefixノード名を再利用する際のノード名のプレフィックス--いいえ
pypi_index_urlpypi インデックスの URL を任意の内部アーティファクトに変更します。https://pypi.org/simple
なし
snapshot_exit_call_details_lengthトランザクションスナップショットの終了コールを記述する詳細文字列の文字数を指定。100
×
transaction_monitor_bt_max_duration_msビジネストランザクションの最長時間（ミリ秒単位）。12000
なし
virtualenv_pathvirtualenv へのパス。install_env が virtualenv に設定されている場合は必須です。noneNone, venv_pathinstall_env= virtualenv の場合は、はい
install_env= default の場合は、いいえ
wsgi_scriptWSGI スクリプトファイルへのパス。

なし
wsgi_callableスクリプト/モジュールで呼び出し可能な WSGI の名前。アプリケーション
なし
wsgi_moduleアプリケーションモジュールの完全修飾名。

×


Ansible® は米国およびその他の国における Red Hat, Inc. の登録商標です。