슬랙 | 설치 매뉴얼 | 로그프레소 스토어

설치 매뉴얼

Slack 워크스페이스 설정

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

Slack 앱 생성
웹훅 설정
User OAuth 토큰 생성
Bot OAuth Token 생성
앱 재설치 및 토큰 복사
채널에 앱 추가

1. Slack 앱 생성

Slack API 앱 관리 페이지로 이동하세요.
Create an App 버튼을 클릭하고 From scratch를 선택하세요.
앱 이름과 워크스페이스를 입력한 후 Create App 버튼을 클릭하세요.

2. 웹훅 설정

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

Features > Incoming Webhooks 메뉴로 이동하세요.
Activate Incoming Webhooks 슬라이더를 활성화하고 Add New Webhook to Workspace 버튼을 클릭하세요.
메시지를 게시할 채널을 선택한 후 Allow 버튼을 클릭하세요.
생성된 Webhook URL을 복사해 안전한 곳에 기록하세요. 로그프레소 접속 프로파일 설정 시 사용합니다.

3. User OAuth 토큰 생성

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

Features > OAuth & Permissions 메뉴로 이동하세요.
Scopes에서 User Token Scopes에 다음 권한을 추가하세요:
- users:read
- users:read.email
- team:read
- auditlogs:read (Enterprise Grid 플랜 전용)
Note

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

4. Bot OAuth Token 생성

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

Features > OAuth & Permissions 메뉴로 이동하세요.
Scopes에서 Bot Token Scopes에 다음 권한을 추가하세요.
- channels:read
- files:write
- groups:read

5. 앱 재설치 및 토큰 복사

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

Settings > Install App 메뉴로 이동하세요.
Reinstall to Workspace 버튼을 클릭하고 권한을 확인한 후 Allow 버튼을 클릭하세요.
설치가 완료되면 User OAuth Token과 Bot User OAuth Token을 복사해 안전한 곳에 기록하세요. 로그프레소 접속 프로파일 설정 시 사용합니다.

6. 채널에 앱 추가

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

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

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

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

1. Slack 접속 프로파일

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

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

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

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

2. 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 웹훅 선택
웹훅 URL: Slack 앱의 Incoming Webhook URL

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

slack-send text="Hello, World"

감사 로그 연동 설정

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

수집기 추가

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

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

AI 에이전트 채널 설정

슬랙 앱 생성

슬랙에서 앱 관리 화면으로 이동하여 Create New App 버튼을 클릭하고 From a manifest를 선택한 후 Continue 버튼을 클릭합니다.

AI 에이전트 앱은 대화 내역 읽기, 메시지 작성, 파일 업로드, 사용자 목록 조회 권한이 필요합니다. 아래 매니페스트 JSON을 복사하여 대화상자에 붙여넣기하고 Workspace를 선택한 후 Next 버튼을 클릭합니다.

{
    "display_information": {
        "name": "Logpresso Agentic SOC"
    },
    "features": {
        "app_home": {
            "home_tab_enabled": false,
            "messages_tab_enabled": true,
            "messages_tab_read_only_enabled": false
        },
        "bot_user": {
            "display_name": "Logpresso Agentic SOC",
            "always_online": true
        }
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "files:write",
                "chat:write",
                "im:history",
                "im:write",
                "users:read",
                "users:read.email"
            ]
        },
        "pkce_enabled": false
    },
    "settings": {
        "event_subscriptions": {
            "bot_events": [
                "message.im"
            ]
        },
        "interactivity": {
            "is_enabled": true
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false,
        "is_mcp_enabled": false
    }
}

이제 대화상자 하단의 Create and Install 버튼을 클릭하여 완료합니다.

이후 로그프레소 접속 프로파일을 설정하려면 위의 화면과 같은 마지막 단계에서 Bot token과 App token을 복사하여 안전한 위치에 보관해야 합니다.

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

이전 단계에서 복사한 봇 OAuth 토큰과 앱 레벨 토큰을 각각 입력하여 로그프레소 접속 프로파일 설정을 완료합니다.

Note

로그프레소에서 2개 이상의 슬랙 봇 프로파일을 설정하면 가장 먼저 검색되는 1개 이외의 프로파일은 무시됩니다.

메신저 연동 설정

슬랙 계정과 로그프레소 계정, AI 에이전트를 매핑하여 슬랙에서 로그프레소 AI 에이전트를 실행할 수 있는 권한을 부여합니다.