Microsoft Teams

개요

Microsoft Teams는 Microsoft 365의 협업 플랫폼으로, 외부 시스템이 보낸 웹후크 요청을 팀 채널에 게시하는 워크플로 기능을 제공합니다. 로그프레소는 Microsoft Teams 앱을 통해 알림이나 모니터링 결과를 Teams 채널로 전송합니다.

적용 범위

요구 사항

Microsoft Teams 설정

Microsoft Teams에 접속하고 워크플로를 생성할 계정으로 로그인하세요.

단계 1: 팀 및 채널 생성

1. 사이드 바에서 채팅을 클릭한 다음, 채팅 및 채널 목록 위에서 새 항목을 클릭하고 새 팀을 선택하세요.

   

2. 팀 만들기 팝업에서 팀 이름, 팀 유형, 첫 번째 채널 이름을 입력한 후 만들기를 클릭하세요.

   

3. 필요한 경우 해당 팀에 구성원을 추가하세요. 나중에 추가하려면 건너뛰기를 클릭합니다.

   

4. 왼쪽 Teams 및 채널 목록에서 생성된 팀과 채널을 확인하세요.

   

단계 2: 워크플로 웹후크 URL 발급

1. 워크플로를 만들려는 채널 옆의 추가 옵션(...)을 클릭한 다음 워크플로를 선택하세요.

   

2. 워크플로 창에서 템플릿 보기를 클릭하세요.

   

3. 템플릿 목록에서 채널에 웹후크 경고 보내기를 선택하세요.

   

4. 매개 변수에서 채널이 있는 팀과 채널을 선택한 후 저장을 클릭하세요.

   

5. 생성된 워크플로 화면에서 웹후크 링크 복사를 클릭하고, 복사한 URL을 안전한 곳에 보관하세요. 이 URL은 로그프레소 접속 프로파일 설정 시 필요합니다.

   

로그프레소 설정

접속 프로파일 추가

시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.

필수 입력 항목을 설정한 후 저장을 클릭하여 접속 프로파일을 추가하세요.

설치 후 검증

아래 쿼리로 실제 메시지 전송이 동작하는지 최종 확인합니다. profile 값은 앞에서 등록한 접속 프로파일의 식별자로 바꿔 실행하세요.

ms-teams-send profile=ms_teams subject="테스트입니다" text="테스트본문입니다."

• 정상: 쿼리 결과에 profile, subject, text 필드를 가진 레코드가 반환되고, 연동한 Teams 채널에 아래와 같은 카드 메시지가 게시됩니다.
• 비정상: 접속 프로파일의 워크플로 URL, Teams 워크플로 활성 상태, 네트워크 도달(HTTPS/443)을 재확인합니다.

여러 건의 검색 결과를 한 번에 전송하려면 ms-teams-send-batch 명령어를 사용합니다. 각 명령어의 옵션은 확장 명령어 매뉴얼을 참고하세요.

참고 자료

• Microsoft Teams 수신 웹후크 만들기
• 로그프레소 소나 공식 문서
• 접속 프로파일 설정 가이드