Python 모니터링

온라인에서 편집하기

Instana 호스트 에이전트를 설치한 후, Instana Python 패키지( Python Tracer 또는 인-프로세스 수집기라고도 함)를 설치하여 Python 애플리케이션을 모니터링하십시오. 이 패키지는 Python 애플리케이션의 성능 지표와 분산 추적을 수집하여 병목 현상을 파악하고 애플리케이션 성능을 최적화하는 데 도움을 줍니다. Instana UI에서 이러한 메트릭과 트레이스를 확인할 수 있습니다.

스탠, Python 을 사랑함

자세한 내용은 Instana host agent를 참조하십시오.

사용량

온라인에서 편집하기

Instana ( Python ) 패키지는 Python 프로세스에서 주요 메트릭과 분산 추적을 자동으로 수집하는 설정 없이 바로 사용할 수 있는 도구입니다.

참고: Instana, Python, 3.0.0 및 이후 버전은 OpenTelemetry API를 통해 사용자 정의 추적 기능을 지원합니다. 자세한 내용은 Python OpenTelemetry 을 참조하십시오.

설치 메소드

온라인에서 편집하기

다음 섹션에 설명된 대로 자동 설치 또는 수동 설치를 사용할 수 있습니다:

자동 설치

온라인에서 편집하기

Instana Instana ( AutoTrace™ )를 통해 Python 애플리케이션을 자동으로 원격 모니터링합니다. 하지만 패키지를 수동으로 설치하려는 경우, 다음의 ‘수동 설치’ 섹션을 참조하십시오.

Kubernetes

온라인에서 편집하기

Instana ( AutoTrace ) 웹훅은 Kubernetes 의 Mutating 웹훅 Admission Controller를 구현한 것으로, 전체 Kubernetes 클러스터에서 Instana 을 사용하여 Python 애플리케이션을 모니터링하는 데 필요한 모든 설정을 자동으로 구성합니다.

Kubernetes 클러스터에 Instana AutoTrace 웹훅을 설치하면, 해당 클러스터에서 실행되는 Python 애플리케이션을 추적하기 위해 별도의 수동 작업을 수행할 필요가 없습니다.

Python 애플리케이션과 Instana 에이전트가 Kubernetes 을 통해 관리되는 경우, 이 구성에서 필요한 설정에 대한 정보는 Kubernetes 네트워크 액세스에 관한 문서를 참조하십시오.

참고: Instana AutoTrace 웹훅은 Python 센서 2.0.0 및 그 이후 버전만 설치하며, Python 2.7 와 같은 구형 런타임은 지원하지 않습니다.

지원되는 관련 구성 요소의 버전을 확인하려면 ‘지원되는 구성 요소 및 버전’을 참조하십시오. 레거시 런타임으로 작업해야 하는 경우 다음을 참조하세요. 수동 설치 부분.

수동 설치

온라인에서 편집하기
참고: 더 이상 사용되지 않는 OpenTracing API를 지원하는 Instana Python 패키지를 설치하는 방법은 Python OpenTracing (더 이상 사용되지 않음) 을 참조하십시오.

다음 명령어를 실행하여 Instana Python 패키지를 가상 환경(virtualenv), pipenv 또는 컨테이너에 수동으로 설치할 수 있습니다:

pip install instana

기존 설치를 업데이트하려면 다음 명령을 실행하십시오.

pip install -U instana

그런 다음 조직의 요구에 따라 다음 두 섹션 중 하나에서 조치를 계속 완료하십시오.

코드 수정 없이 활성화하기

온라인에서 편집하기

Instana 이 방법은 애플리케이션의 코드 한 줄도 수정하지 않고도 Instana Python 패키지를 활성화할 수 있는 방법을 제공합니다. 이를 통해 가져오기 요청, 품질 보증, 스테이징 및 프로덕션에 대한 배치와 같은 애플리케이션 코드 변경과 관련된 많은 프로세스를 피할 수 있습니다.

코드를 수정하지 않고 Instana 패키지를 활성화하려면, Python 애플리케이션에 대해 다음 환경 변수를 설정하기만 하면 됩니다:

export AUTOWRAPT_BOOTSTRAP=instana

Instana ( Python ) 패키지는 애플리케이션 부팅 시 자동으로 로드되어 Python 애플리케이션을 모니터링합니다.

참고: 이 활성화 방법은 `gevent` 기반 애플리케이션에서는 작동하지 않습니다. 활성화가 이루어지기 전에 `gevent`를 먼저 활성화하고 ` monkey.patch_all ()` 함수를 호출해야 하기 때문입니다. Python3.12 및 이후 버전에서 `AUTOWRAPT_BOOTSTRAP` 환경 변수를 사용하려면 `setuptools` 패키지를 설치해야 합니다.

코드 변경을 통한 활성화

온라인에서 편집하기

또는 instana 패키지를 Python 애플리케이션 코드 내부로 수동으로 가져오려면 애플리케이션 코드에 다음을 추가하십시오.

import instana

Django, Flask, 최종 사용자 모니터링(EUM) 등에 대한 자세한 내용은 ‘프레임워크’ 섹션을 참조하십시오.

구성

온라인에서 편집하기

즉시 사용 가능한 메트릭 및 분산 추적의 경우 구성이 필요하지 않습니다. 그러나 개별 컴포넌트는 구성 가능합니다. 자세한 내용은 ` Python ` 구성 항목을 참조하십시오.

Cloud Foundry

온라인에서 편집하기
참고: 이 섹션은 Cloud Foundry 파운데이션의 Diego 노드에서 Instana 에이전트가 실행 중이라고 가정합니다. 기반이 되는 Diego 셀에서 에이전트가 실행되고 있지 않으면, Cloud Foundry 애플리케이션의 모니터링은 지원되지 않습니다.

게다가 타일 버전 이후로1.177.0 ,instana_buildpack 설정을 자동화합니다Python 응용 프로그램Cloud Foundry . 자세한 내용은 Instana 의 빌드팩 문서를 참조하십시오.

Instana 에이전트 설정 방법 및 관련 Cloud Foundry 또는 Pivotal Platform 기능에 대한 자세한 내용은 Cloud Foundry 및 Pivotal Platform 설명서를 참조하십시오.

Python Cloud Foundry 애플리케이션을 모니터링하려면 다음 단계를 수행해야 합니다.

  • instana Python 패키지를 requirements.txt 파일에 추가하십시오.
  • 다음과 같이 값이 instana 인 AUTOWRAPT_BOOTSTRAP 환경 변수를 애플리케이션 Manifest에 추가하십시오.
  • cf push Cloud Foundry 애플리케이션
---
applications:
- name: test-python-flask
  buildpacks:
    - python_buildpack
  env:
    AUTOWRAPT_BOOTSTRAP: instana

소프트웨어 개발 키트(SDK)

온라인에서 편집하기

Instana 의 SDK를 활용하면 다른 도구 및 서비스와 원활하게 연동할 수 있습니다.

Instana 네이티브 SDK

온라인에서 편집하기

Instana 의 Python 트레이서 패키지에는 Python 용 트레이싱 SDK가 포함되어 있습니다. 이 SDK는 공개 오픈 소스 라이브러리( API ) 형태로 제공됩니다. 전체 소스 코드 및 코드 포지에 대한 자세한 내용은 Instana 의 Python 트레이서 패키지를 참조하십시오. Python 추적 SDK 설치에 대한 자세한 내용은 ‘설치 방법’ 섹션을 참조하십시오. Python 애플리케이션에 계측 기능을 적용하는 방법에 대한 예시는 Python Tracing SDK를 참조하십시오.

OpenTelemetry

온라인에서 편집하기

Instana Python 3.0.0 그리고 이후 버전들은 OpenTelemetry ( OTel ) API를 통해 사용자 정의 추적 기능을 지원합니다. OTel 애플리케이션에서 메트릭, 로그, 트레이스 등의 텔레메트리 데이터를 계측, 수집 및 분석할 수 있게 해주는 관측성 프레임워크입니다. 자세한 내용은 OpenTelemetry 포털을 참조하십시오.

OpenTracing

온라인에서 편집하기

Instana Python 2.5.3 그리고 이전 버전들은 더 이상 사용되지 않는 OpenTracing API를 통해 사용자 정의 추적 기능을 지원합니다. 자세한 내용은 Python OpenTracing 을 참조하십시오.