수집 에이전트 개요
수집 에이전트는 Azure Operator Insights 데이터 제품에 데이터를 업로드합니다. 네트워크에서 데이터를 업로드하기 위해 Linux 가상 머신에 설치할 수 있는 Azure Operator Insights 수집 에이전트라는 수집 에이전트를 제공합니다. 이 수집 에이전트는 다음 업로드를 지원합니다.
- MCC(모바일 콘텐츠 클라우드) EDR(이벤트 데이터 레코드) 데이터 스트림이 확인되었습니다.
- SFTP 서버에 저장된 파일입니다.
하나의 에이전트 인스턴스에 다양한 형식의 원본을 결합하는 것은 프로덕션에서는 권장되지 않지만 랩 평가판 및 테스트에서는 지원됩니다.
MCC EDR 원본 개요
MCC EDR 원본으로 구성된 수집 에이전트는 Affirmed Networks MCC(모바일 콘텐츠 클라우드)와 함께 사용하도록 설계되었습니다. MCC 네트워크 요소에서 EDR(이벤트 데이터 레코드)을 수집하여 Azure Operator Insights에 업로드합니다. 자세한 내용은 QoE(체감 품질) - 확정된 MCC 데이터 제품을 참조하세요.
SFTP 풀 원본 개요
SFTP 풀 원본으로 구성된 수집 에이전트는 하나 이상의 SFTP 서버에서 파일을 수집하여 Azure Operator Insights에 업로드합니다.
파일 원본
수집 에이전트는 사용자가 구성한 수집 파이프라인에서 파일을 수집합니다. 파이프라인에는 SFTP 서버의 세부 정보, SFTP 서버에서 수집할 파일, 해당 파일을 관리하는 방법이 포함됩니다.
예를 들어 단일 SFTP 서버에 로그, CSV 파일 및 텍스트 파일이 있을 수 있습니다. 각 파일 형식을 별도의 수집 파이프라인으로 구성할 수 있습니다. 각 수집 파이프라인에 대해 파일을 수집할 디렉터리(선택적으로 파일 경로에 따라 특정 파일을 포함하거나 제외), 파일 수집 빈도 및 기타 옵션을 지정할 수 있습니다. 사용 가능한 옵션에 대한 자세한 내용은 Azure Operator Insights 수집 에이전트 구성 참조를 참조하세요.
수집 파이프라인에는 다음과 같은 제한 사항이 있습니다.
- 중복되어서는 안 됩니다. 즉, 동일한 서버에서 동일한 파일을 수집해서는 안 됩니다.
- 정확히 하나의 에이전트에 각 파이프라인을 구성해야 합니다. 여러 에이전트에서 파이프라인을 구성하는 경우 Azure Operator Insights는 중복 데이터를 수신합니다.
파일 처리
수집 에이전트는 예약된 업로드 실행 중에 Azure Operator Insights에 파일을 업로드합니다. 이러한 실행 빈도는 파이프라인 구성에서 정의됩니다. 각 업로드 실행은 파이프라인 구성에 따라 파일을 업로드합니다.
- 파일을 포함 및 제외하기 위한 파일 경로와 정규식에서 업로드할 파일을 지정합니다.
- 정착 시간에서는 이 기간 내에 마지막으로 수정된 파일이 업로드에서 제외됩니다. 예를 들어 업로드 실행이 05:30에 시작되고 정착 시간이 60초(1분)인 경우 업로드 실행은 05:29 이전에 수정된 파일만 업로드합니다.
- 시간 전에 제외(설정된 경우)에서는 지정된 날짜와 시간 이전에 마지막으로 수정된 파일이 제외됩니다.
수집 에이전트는 파일 원본에 대한 업로드 실행을 마지막으로 완료한 시간을 기록합니다. 다음 프로세스를 수행하여 이 레코드를 사용해 다음 업로드 실행 중에 업로드할 파일을 결정합니다.
- 에이전트에서 마지막으로 기록된 시간을 확인합니다.
- 에이전트는 해당 시간 이후에 수정된 모든 파일을 업로드합니다. 이전 업로드 실행 중에 이전 파일을 처리했다고 가정합니다.
- 업로드 실행 종료 시:
- 에이전트가 모든 파일을 업로드했거나 유일한 오류가 다시 시도할 수 없는 오류이면 에이전트에서 레코드를 업데이트합니다. 새 시간은 업로드 실행이 시작된 시간을 기준으로 하며 정착 시간을 뺀 시간입니다.
- 업로드 실행에 다시 시도 가능한 오류(예: Azure에 대한 연결이 끊어진 경우)가 있으면 에이전트는 레코드를 업데이트하지 않습니다. 레코드를 업데이트하지 않으면 에이전트가 성공적으로 업로드되지 않은 모든 파일에 대해 업로드를 다시 시도할 수 있습니다. 다시 시도는 이전에 업로드한 데이터를 복제하지 않습니다.
수집 에이전트는 낮은 수준의 네트워크 중단에도 매우 안정적이고 탄력적으로 설계되었습니다. 예기치 못한 오류가 발생하면 에이전트가 실행되자마자 다시 시작되어 서비스를 다시 제공합니다. 다시 시작한 후 에이전트는 구성된 모든 파일 원본에 대해 즉시 캐치업 업로드 실행을 수행합니다. 그런 다음, 구성된 일정으로 돌아갑니다.
인증
수집 에이전트는 별도의 자격 증명을 사용하여 두 개의 별도 시스템을 인증합니다.
- Azure Operator Insights 데이터 제품의 수집 엔드포인트를 인증하기 위해 에이전트는 Azure Key Vault에서 SAS 토큰을 가져옵니다. 에이전트는 Microsoft Entra ID 관리 ID 또는 에이전트를 만들 때 설정한 서비스 주체 및 인증서를 사용하여 이 Key Vault를 인증합니다.
- SFTP 서버에 인증하기 위해 에이전트에서 암호 인증이나 SSH 키 인증을 사용할 수 있습니다.
구성 지침은 Azure에 대한 인증 설정, VM 준비 및 에이전트 소프트웨어 구성을 참조하세요.