Monitoring Python -Instana Python 套件

Kubernetes

Instana AutoTrace WebHook 是 Kubernetes 轉換 WebHook 許可控制器的實作，它會在整個 Kubernetes 叢集中自動設定使用 Instana 監視 Python 應用程式所需的一切。

如果您在 Kubernetes 叢集上安裝 Instana AutoTrace WebHook ，則不需要執行任何手動步驟來追蹤在那些叢集裡執行的 Python 應用程式。

如果您的 Python 應用程式及 Instana 代理程式是由 Kubernetes管理，請檢查 Kubernetes 網路存取權 上的說明文件，以取得此設定中所需配置的相關資訊。

附註: Instana AutoTrace WebHook 只會安裝 Python 感應器 2.0.0 及更新版本，不會提供對舊式執行時期 (例如 Python 2.7) 的支援。 若要檢查支援哪些版本的相關元件，請參閱 支援的元件及版本。 如果您需要使用舊式執行時期，請參閱下列 手動安裝 小節。

已淘汰: 舊式 Python AutoTrace

透過主機代理程式機制自動安裝 Python AutoTracing 已 淘汰。

監視 Python 應用程式的偏好方法是 AutoTrace WebHook ，它提供增加的穩定性及可防止未來的解決方案。 不過，此方法僅適用於 Kubernetes/OpenShift。 如果您的應用程式不在 Kubernetes上，您可以執行下列步驟:

1. 手動檢測 Python 應用程式。
2. 暫時啟用已淘汰的 透過主機代理程式的舊式自動安裝機制 (僅限Linux x86 ) ，直到發生手動檢測為止。 附註: 這需要檢測機器能夠呼叫到 pip。 附註: 這些步驟在氣隙環境或限制輸出的類似環境中無法運作。

適用於 Python 3.7 以及更新版本的執行時期

您可以執行下列指令，將 Instana Python 套件手動安裝至 virtualenv、pipenv 或儲存器:

pip install git+https://github.com/instana/python-sensor@v2.0.7

若為 Python 3.6 及更早版本的運行環境

Instana Python 套件 (在 PyPI上管理) ( 2.0.0 版及更舊版本) 適用於舊式 Python 執行時期版本 (小於或等於 3.6)。 若要安裝 PyPI管理的 Instana Python 套件，請執行下列指令:

pip install instana

若要更新現有安裝，請執行下列指令:

pip install -U instana

然後，根據您組織的需求，繼續完成下列兩個區段之一的動作。

在沒有程式碼變更的情況下啟動

Instana 提供一種方法來啟動 Instana Python 套件，而無需修改應用程式中的單一程式碼行。 這可讓您避免涉及應用程式碼變更的許多處理程序，例如拉取要求、品質保證、暫置及部署至正式作業。

若要啟動 Instana 套件而不進行任何程式碼變更，只需為 Python 應用程式設定下列環境變數:

export AUTOWRAPT_BOOTSTRAP=instana

Instana Python 套件將在應用程式開機時自動載入，並檢測您的 Python 應用程式。

• 附註: 此啟動方法將不適用於以 gevent為基礎的應用程式。 這是因為必須先啟動 gevent 並呼叫 monkey.patch_all() 。

使用程式碼變更來啟動

或者，若要手動將 instana 套件匯入至 Python 應用程式碼內，請將下列內容新增至應用程式碼:

import instana

如需 Django、Flask、End-user Monitoring (EUM) 及其他相關資訊，請參閱 Frameworks 一節。