incident.io에 앱을 연결해 인시던트, 후속 작업, 알림, 온콜 일정, 상태 페이지, 카탈로그 데이터를 다룹니다.
incident.io에 앱 연결하기
incident.io에 앱을 연결해 인시던트, 후속 작업, 알림, 온콜 일정, 상태 페이지, 카탈로그 데이터를 다루세요.
incident.io는 대응을 조율하고, 온콜 일정을 관리하고, 상태를 공유하고, 후속 작업을 추적하는 인시던트 관리 플랫폼입니다. incident.io 커넥터를 사용하면 Lovable 앱이 incident.io API로 운영 데이터를 읽고 관리할 수 있습니다.
incident.io는 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
incident.io를 사용하면 앱에서 다음 작업을 할 수 있습니다.
- 인시던트 목록 조회 및 상태, 심각도, 타임라인, 업데이트 표시
- 연결된 API 키에 필요한 권한이 있을 때 인시던트 생성 및 업데이트
- 후속 작업과 미완료 대응 작업 추적
- 알림과 온콜 일정 검토
- 상태 페이지 정보 표시
- 서비스, 팀, 기타 운영 리소스의 카탈로그 데이터 읽기 및 관리
incident.io는 인시던트 대응 데이터를 내부 도구, 고객 대상 상태 페이지 경험, 운영 대시보드에 가져오고 싶을 때 적합합니다.
주요 활용 사례 및 예시 앱
앱의 기존 워크플로우와 함께 운영 데이터나 인시던트 대응 동작이 필요할 때 incident.io를 사용하세요.
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 인시던트 지휘 대시보드 | incident.io를 사용해 진행 중인 인시던트를 심각도, 상태, 지휘자, 최신 업데이트와 함께 나열하는 대시보드를 만들어줘. | 대응 인력에게 활성 인시던트에 집중한 보기를 제공합니다. 앱이 현재 인시던트 데이터를 읽고 대응 중 팀에 필요한 세부 정보를 강조합니다. |
| 인시던트 접수 도구 | incident.io를 사용해 요약과 심각도를 입력해 새 인시던트를 생성하는 내부 양식을 만들어줘. | 팀에 맞춘 워크플로우에서 인시던트를 선언합니다. 앱이 양식을 검증하고, 연결된 키에 인시던트 관리 권한이 있으면 인시던트를 생성합니다. |
| 후속 작업 추적기 | incident.io를 사용해 미완료 후속 작업을 인시던트, 담당자, 마감일별로 묶어 보여주는 추적기를 만들어줘. | 인시던트 이후 작업을 완료될 때까지 계속 보이게 합니다. 앱이 후속 작업을 읽어 바로 실행할 수 있는 운영 보기로 정리합니다. |
| 온콜 디렉터리 | incident.io를 사용해 일정별 현재 담당자와 다음 담당자를 보여주는 온콜 디렉터리를 만들어줘. | 팀이 적합한 대응 담당자를 빠르게 찾도록 돕습니다. 앱이 온콜 일정을 읽어 현재와 다음 담당 시간을 보여줍니다. |
| 상태 페이지 뷰어 | incident.io를 사용해 활성 인시던트와 최근 업데이트를 보여주는 공개 상태 페이지를 만들어줘. | 직접 관리하는 앱에서 서비스 상태를 알립니다. 앱이 상태 페이지 데이터를 읽어 인시던트 업데이트를 사용자에게 렌더링합니다. |
| 알림 검토 콘솔 | incident.io를 사용해 최근 알림을 소스, 우선순위, 관련 인시던트별로 묶는 콘솔을 만들어줘. | 수신 알림을 검토 가능한 운영 대기열로 바꿉니다. 앱이 알림 데이터를 읽어 운영자가 패턴과 에스컬레이션 필요성을 파악하도록 돕습니다. |
| 서비스 카탈로그 탐색기 | incident.io를 사용해 소유자, 팀, 관련 운영 메타데이터가 포함된 검색 가능한 서비스 카탈로그를 만들어줘. | 서비스 소유권을 더 쉽게 찾을 수 있게 합니다. 앱이 incident.io 카탈로그 항목을 읽어 검색 가능한 디렉터리로 보여줍니다. |
incident.io 연결하기
incident.io 연결을 만들 수 있는 사용자는 플랜과 워크스페이스 설정에 따라 달라집니다. 연결 및 클라이언트를 만들 수 있는 사용자를 참고하세요.
Free, Pro, Business 플랜에서는 앱 + 채팅 커넥터를 기본적으로 사용할 수 있습니다. Enterprise 플랜에서는 처음에 사실상 비활성화되어 있습니다. 관리자가 Connectors → Admin settings → App + chat connectors에서 변경하기 전까지 연결 및 클라이언트를 만들 수 있는 사용자가 No one으로 설정됩니다.
서로 다른 API 키로 여러 incident.io 연결을 만들 수 있어 환경, incident.io 계정, 권한 집합을 분리할 때 유용합니다.
연결이 만들어지면 사용하려는 프로젝트에 연결을 링크할 수 있습니다. 프로젝트에서 빌드하는 사람은 누구나 채팅에서 Lovable에게 프로젝트를 이 연결에 링크해 달라고 요청할 수 있습니다.
사전 준비
incident.io를 연결하기 전에 다음을 준비하세요.
- API 키를 만들 수 있는 incident.io 계정
- 앱에 필요한 권한을 가진 incident.io API 키
- Lovable 워크스페이스에서 연결을 만들 수 있는 권한(연결 및 클라이언트를 만들 수 있는 사용자 참고)
이 커넥터를 통한 API 요청은 incident.io의 API 한도와 해당하는 incident.io 플랜 사용량에 포함됩니다. 청구와 할당량은 Lovable이 아닌 incident.io에서 직접 처리합니다.
Step 1: incident.io API 키 가져오기
incident.io API 키를 사용하면 Lovable 앱이 incident.io API에 인증할 수 있습니다. 키를 만들 때 계정 수준 권한, 팀 범위 권한, 또는 둘 다를 사용해 키로 할 수 있는 작업을 정합니다.
incident.io API 키를 만들려면 다음과 같이 진행하세요.
API 키 설정 열기
incident.io API 키 설정에 로그인합니다.
API 키 만들기
새 키를 만들고 알아보기 쉬운 이름(예: Lovable production)을 지정합니다.
권한 선택하기
앱에 필요한 권한만 선택합니다. 앱이 인시던트, 후속 작업, 카탈로그 데이터를 만들거나 변경하는 경우에만 쓰기 권한을 포함하세요.
API 키 복사하기
incident.io가 키를 표시하면 복사해 안전하게 보관합니다. incident.io는 토큰을 한 번만 보여줍니다.
API 키는 비밀번호처럼 작동합니다. Lovable의 incident.io 연결 양식에만 붙여넣으세요. 프롬프트, URL, 브라우저 코드, 소스 파일, 채팅 메시지에 넣지 마세요.
자세한 내용은 incident.io 문서 incident.io API 인증을 참고하세요.
Step 2: incident.io를 Lovable에 연결하기
연결 양식을 열고 incident.io에서 만든 API 키를 입력합니다.
Connectors에서 incident.io 열기
Connectors를 열고 incident.io를 선택합니다. 커넥터 카탈로그를 여는 다른 방법은 커넥터를 찾을 수 있는 위치를 참고하세요.
연결 추가하기
Add connection을 클릭합니다.
연결 구성하기
- Display name: 연결 이름을 지정합니다(예:
incident.io Prod). 이 이름은 Lovable 내부에서 연결을 식별할 때만 사용됩니다. - API key: incident.io API 키를 붙여넣습니다.
이 연결을 사용할 사용자 선택하기
Who can use this connection에서 워크스페이스 내 연결 사용자를 결정합니다. 처음에는 본인만 접근할 수 있습니다.
- Only you(기본값): 접근 목록을 그대로 두면 본인만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 이메일로 워크스페이스 멤버를 추가하면 본인과 추가한 사용자만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스의 모든 사용자가 연결을 사용할 수 있습니다.
자세한 내용은 연결 및 클라이언트를 사용할 수 있는 사용자를 참고하세요.
연결하기
Connect를 클릭합니다. Lovable이 연결을 저장하기 전에 incident.io로 키를 검증합니다.
연결되면 프로젝트에서 빌드하는 사람은 누구나 구성된 연결 수준 접근 권한에 따라 채팅에서 Lovable에게 프로젝트를 incident.io에 링크해 달라고 요청할 수 있습니다. 이후 Lovable 앱은 incident.io API 키를 브라우저 코드에 노출하지 않고 Lovable의 서버 측 커넥터 게이트웨이를 거쳐 incident.io를 호출할 수 있습니다.
제한 사항
incident.io 커넥터는 공유 API 키를 사용하며 요청을 Lovable의 서버 측 게이트웨이 뒤에서 처리합니다.
- 각 연결은 하나의 공유 incident.io API 키를 사용합니다. 커넥터는 최종 사용자별 incident.io 로그인을 지원하지 않습니다.
- 연결된 키가 앱이 읽고 변경할 수 있는 데이터를 결정합니다. Lovable은 키에 없는 권한을 부여할 수 없습니다.
- Lovable은 incident.io API 키를 자동으로 교체하지 않습니다. 키를 교체하려면 incident.io에서 새 키를 만들고 Lovable 연결을 업데이트하세요.
- 호출은 반드시 Lovable의 서버 측 커넥터 게이트웨이를 통해야 합니다. 브라우저 코드에서
api.incident.io를 직접 호출하거나 생성된 앱 코드에 API 키를 노출하지 마세요.
문제 해결
incident.io 응답 상태 코드로 자격 증명, 권한, 속도 제한 문제를 파악하세요.
401응답은 대개 키가 유효하지 않거나 취소되었다는 뜻입니다. incident.io에서 대체 키를 만들고 연결을 업데이트하세요.403응답은 키에 해당 엔드포인트에 대한 권한이 없다는 뜻입니다. 필요한 incident.io 권한을 가진 키를 만들거나 업데이트하세요. 같은 요청을 다시 시도해도 누락된 권한은 해결되지 않습니다.- incident.io는 속도 제한을 적용합니다. API 키당 분당 1,200개 요청이 기본 한도이며 일부 엔드포인트는 한도가 더 낮습니다. 반복되는 읽기는 캐시하고
429응답과Retry-After헤더를 준수하세요.
incident.io 연결 관리
연결은 Connectors에서 관리합니다. **incident.io**를 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 incident.io 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, incident.io를 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.