슬랙

구독
다운로드 172
업데이트 2025. 12. 25.

설치 매뉴얼

Slack 워크스페이스 설정

로그프레소 Slack 앱은 Slack 워크스페이스에 생성한 API 토큰을 사용합니다. Slack 앱을 생성하고 필요한 권한을 설정하세요.

  1. Slack 앱 생성
  2. 웹훅 설정
  3. User OAuth 토큰 생성
  4. Bot OAuth Token 생성
  5. 앱 재설치 및 토큰 복사
  6. 채널에 앱 추가

1. Slack 앱 생성

  1. Slack API 앱 관리 페이지로 이동하세요.

  2. Create an App 버튼을 클릭하고 From scratch를 선택하세요.

    Slack 앱 생성

  3. 앱 이름과 워크스페이스를 입력한 후 Create App 버튼을 클릭하세요.

2. 웹훅 설정

로그프레소 소나가 Slack 채널로 메시지를 전송하려면 웹훅을 설정해야 합니다.

  1. Features > Incoming Webhooks 메뉴로 이동하세요.

  2. Activate Incoming Webhooks 슬라이더를 활성화하고 Add New Webhook to Workspace 버튼을 클릭하세요.

    웹훅 설정

  3. 메시지를 게시할 채널을 선택한 후 Allow 버튼을 클릭하세요.

  4. 생성된 Webhook URL을 복사해 안전한 곳에 기록하세요. 로그프레소 접속 프로파일 설정 시 사용합니다.

3. User OAuth 토큰 생성

로그프레소 소나에서 Slack 워크스페이스의 사용자 정보를 조회하려면 OAuth 토큰이 필요합니다.

  1. Features > OAuth & Permissions 메뉴로 이동하세요.

    OAuth 설정

  2. Scopes에서 User Token Scopes에 다음 권한을 추가하세요:

    • users:read
    • users:read.email
    • team:read
    • auditlogs:read (Enterprise Grid 플랜 전용)

    User OAuth Scopes

    Note
    감사 로그 조회 권한(auditlogs:read)은 슬랙 요금제 중 Enterprise+ 플랜에서만 사용할 수 있습니다. Free, Pro, Business+ 플랜에서 이 권한을 추가하면 앱을 설치할 수 없습니다.

4. Bot OAuth Token 생성

로그프레소 대시보드 이미지를 Slack 채널로 전송하려면 Bot OAuth Token이 필요합니다.

  1. Features > OAuth & Permissions 메뉴로 이동하세요.

  2. Scopes에서 Bot Token Scopes에 다음 권한을 추가하세요.

    • channels:read
    • files:write
    • groups:read

    Bot OAuth Scopes

5. 앱 재설치 및 토큰 복사

권한 변경 사항을 적용하려면 앱을 재설치해야 합니다.

  1. Settings > Install App 메뉴로 이동하세요.

  2. Reinstall to Workspace 버튼을 클릭하고 권한을 확인한 후 Allow 버튼을 클릭하세요.

    앱 재설치

  3. 설치가 완료되면 User OAuth Token과 Bot User OAuth Token을 복사해 안전한 곳에 기록하세요. 로그프레소 접속 프로파일 설정 시 사용합니다.

    토큰 복사

6. 채널에 앱 추가

Slack 봇이 메시지를 전송할 채널에 앱을 추가하세요.

채널에 앱 추가

로그프레소 접속 프로파일 설정

로그프레소 스토어에서 내려받은 Slack 앱을 로그프레소 소나에 설치한 후, 이 문서를 참고해 접속 프로파일을 추가하세요. Slack 앱은 용도에 따라 3 가지 유형의 접속 프로파일을 제공합니다.

  1. Slack 접속 프로파일: 사용자 정보 조회 및 감사 로그 수집
  2. Slack 봇 접속 프로파일: 대시보드 이미지를 채널로 전송
  3. Slack 웹훅 접속 프로파일: 텍스트 메시지를 채널로 전송

1. Slack 접속 프로파일

Slack 사용자 정보 조회 및 감사 로그 수집에 사용합니다.

Slack 접속 프로파일 설정

다음은 접속 프로파일 설정 중 필수 입력 항목입니다.

  • 이름: 접속 프로파일을 식별할 고유한 이름
  • 식별자: 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자
  • 유형: Slack 선택
  • API 토큰: Slack 앱의 User OAuth Token 값

쿼리 창에서 slack-users 명령을 실행하고 쿼리 결과가 정상적으로 조회되는지 확인하세요.

slack-user 명령 실행 결과 예시

2. Slack 봇 접속 프로파일

로그프레소 대시보드 이미지를 Slack 채널로 전송할 때 사용합니다.

Slack 봇 접속 프로파일 설정

다음은 접속 프로파일 설정 중 필수 입력 항목입니다.

  • 이름: 접속 프로파일을 식별할 고유한 이름
  • 식별자: 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자
  • 유형: Slack 봇 선택
  • API 토큰: Slack 앱의 Bot User OAuth Token 값

쿼리 창에서 다음 명령을 실행하고 결과를 확인하세요(dashboard-guid는 전송할 대시보드의 GUID를 확인하고 변경해 입력해야 합니다). 쿼리 결과에서 status가 success로 표시되고, 지정한 Slack 채널에서 대시보드 이미지를 확인할 수 있어야 합니다.

slack-send-dashboard-images dashboard-guid=431874ee-f03a-4033-986c-0bbcd383b378 channel=#logpresso

3. Slack 웹훅 접속 프로파일

Slack 채널로 텍스트 메시지를 전송할 때 사용합니다.

Slack 웹훅 접속 프로파일 설정

다음은 접속 프로파일 설정 중 필수 입력 항목입니다.

  • 이름: 접속 프로파일을 식별할 고유한 이름
  • 식별자: 로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자
  • 유형: Slack 웹훅 선택
  • 웹훅 URL: Slack 앱의 Incoming Webhook URL

쿼리 창에서 다음 명령을 실행하고 지정한 Slack 채널에 "Hello, World" 메시지가 전송되는지 확인하세요.

slack-send text="Hello, World"

감사 로그 연동 설정

Slack 감사 로그를 수집하려면 "1. Slack 접속 프로파일" 단락을 참고하여 접속프로파일을 추가한 뒤 감사 로그 수집기를 등록합니다.

수집기 추가

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

Slack 감사 로그 수집기 설정

구분항목설정
필수이름수집기를 식별할 고유한 이름
필수적재 위치/수집 위치로그프레소 플랫폼 구성에 따라 적합한 노드 선택
필수수집 모델Slack Audit 선택
필수테이블SLACK_AUDIT 로 시작하는 테이블 이름 직접 입력 (예: SLACK_AUDIT)
필수접속 프로파일단계 1에서 추가한 Slack 접속 프로파일의 식별자