메인 콘텐츠로 건너뛰기
Coralogix 계정을 연결하면 CloudThinker 에이전트가 옵저버빌리티 스택 전반에서 로그를 검색하고, 메트릭과 트레이스를 쿼리하고, 인시던트를 분류하고, 데이터 파이프라인 상태를 검사할 수 있습니다. Coralogix는 리전에 스코프가 지정된 API 키로 인증합니다. CloudThinker는 리전에서 올바른 Coralogix 엔드포인트를 확인하므로, 동일한 설정이 모든 US, EU, AP 데이터 센터에서 작동합니다.

​
지원 리전

Coralogix 팀 로그인 도메인과 일치하는 리전을 선택하세요.
데이터 센터리전
USus1, us2, us3
유럽eu1, eu2
아시아 태평양ap1, ap2, ap3

​
사전 요구 사항

  • 조사할 팀에 접근 권한이 있는 Coralogix 계정.
  • CloudThinker가 접근할 옵저버빌리티 데이터에 대한 읽기 권한이 있는 API 키.
  • Coralogix 팀의 리전.
읽기 전용 조사에 필요한 최소 권한으로 API 키를 사용하세요. CloudThinker의 설정 검증은 데이터만 읽으며 Coralogix 리소스를 수정하지 않습니다.

​
설정

1

Coralogix 열기

Coralogix 계정에 로그인합니다. 로그인 URL은 https://<team>.app.<region>.coralogix.com 형식으로, <region> 부분이 리전입니다.
2

API 키 생성

Settings → Users and Teams → API Keys로 이동하여 Add key를 클릭합니다.
  • Name: cloudthinker
  • Type: Team Key를 선택합니다. 팀 키는 공유 키로, 생성자의 접근 권한이 만료되더라도 유효하게 유지됩니다. 개인 키는 개인에 연결되어 테스트용으로만 사용됩니다.
  • Permissions: CloudThinker가 접근해야 할 데이터에 대한 읽기 권한 부여
키를 즉시 복사하세요 — 이후에는 다시 표시되지 않을 수 있습니다.
3

CloudThinker에 연결 추가

Connections → Coralogix로 이동하여 다음을 입력합니다.
  • API Key: 방금 생성한 키
  • Region: 로그인 URL의 리전 (예: eu2)
Connect를 클릭합니다. CloudThinker가 자격 증명을 검증하고 Connected 상태를 표시합니다.
생성 후 API 키를 즉시 복사하세요. 분실 시 새 키를 생성해야 합니다.

​
연결 세부 정보

필드설명예시
CORALOGIX_API_KEYCoralogix API 키—
CORALOGIX_REGION팀 로그인 도메인의 리전us2
CloudThinker는 리전에서 Coralogix API 엔드포인트를 유도하므로 수동 URL 구성이 필요하지 않습니다.

​
필수 권한

CloudThinker가 조사하는 옵저버빌리티 데이터(로그, 메트릭, 트레이스, 인시던트, 알림, 커넥터, 파싱 규칙, 프리셋, 대시보드)에 대한 읽기 권한을 API 키에 부여합니다.
최소 권한 원칙을 따르세요. 조사에는 읽기 전용 키로 충분합니다. 특정 쓰기 워크플로가 필요한 경우가 아니라면 CloudThinker가 사용하는 키에 변경 권한을 부여하지 마세요.

​
에이전트 기능

연결 후 에이전트는 Coralogix 옵저버빌리티 데이터에 읽기 접근 권한을 갖습니다.
기능설명
탐색계정 상태 요약 — 활성 인시던트, 커넥터 수, 비활성화된 파싱 규칙, 메트릭 미매칭 처리
인시던트 분류활성 인시던트 목록 조회 및 컨텍스트 검사
로그시간 범위에 걸쳐 로그 검색 및 분석
메트릭메트릭 쿼리 및 메트릭 카탈로그 검사
트레이스분산 트레이스 검사
파이프라인 상태잘못 구성된 커넥터, 파싱 규칙, 프리셋 검토
알림 및 대시보드알림 정의 및 대시보드 검사

​
연결 확인

@alex run Coralogix discovery and summarize active incidents, connector count, disabled parsing rule count, and whether metric no-match handling is healthy

​
예시 프롬프트

@alex triage active Coralogix incidents and #report anything affecting production
@alex search Coralogix logs for 5xx errors in the api-gateway over the last hour
@alex check Coralogix pipeline health and list any disabled parsing rules
크거나 노이즈가 많은 카탈로그의 경우, 짧은 시간 범위와 알려진 메트릭 또는 로그 쿼리로 요청 범위를 좁혀 에이전트가 집중적인 결과를 반환하도록 하세요.

​
문제 해결

API 키가 누락되었거나, 만료되었거나, 필요한 권한이 없습니다. 필요한 읽기 권한으로 새 Coralogix API 키를 생성하고 다시 연결하세요.
API 키가 다른 Coralogix 리전에 속합니다. 팀 로그인 도메인을 확인하고 CORALOGIX_REGION을 일치하도록 업데이트하세요.
메트릭 카탈로그에 일치하는 메트릭이 없거나 계정에 메트릭 데이터가 없습니다. 빈 결과로 처리한 후 알려진 메트릭 이름으로 시도하거나 인시던트와 로그로 계속 진행하세요.
하나 이상의 Coralogix 목록 호출이 오류를 반환했습니다. API 키 권한과 리전을 확인한 후 탐색을 다시 실행하세요.
범위가 없는 카탈로그 또는 쿼리 사용은 너무 많은 데이터를 반환합니다. 짧은 시간 범위와 특정 쿼리로 요청 범위를 좁혀 결과가 집중적으로 유지되도록 하세요.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 올바른 리전 — API 키의 리전을 Coralogix 팀 로그인 도메인과 일치시키세요. 리전이 일치하지 않으면 404 오류가 발생합니다.

​
관련 항목

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48

Datadog 연결

로그 검색, 메트릭, 모니터링
https://mintcdn.com/cloudthinker/uIxpc0ZqZtveGXWt/images/icons/betterstack.svg?fit=max&auto=format&n=uIxpc0ZqZtveGXWt&q=85&s=61b580a94f2f0b8abd07eb7f494739c2

Better Stack 연결

업타임, 인시던트, 로그 검색