docs.logbrew.co
전체 문서 사이트
긴 설정 안내, API 세부 정보, 예제는 제품 소개 페이지를 복잡하게 만들지 않도록 전용 문서 사이트에서 보세요.
문서 사이트 열기플랫폼 선택
텔레메트리를 보낼 앱이나 프레임워크를 선택하세요. 프로젝트 추가에서도 같은 항목을 선택하세요.
설치 명령
첫 SDK 실행 성공하기
첫 세션은 간단하게 하세요. 패키지를 설치하고, 프로젝트를 만들고, 비밀 정보가 없는 제품 액션을 하나 보낸 다음 LogBrew에서 확인하세요.
- 1SDK 설치로그, 스팬, 액션, 릴리스, 메트릭이 필요한 백엔드 서비스에는 Node 패키지를 사용하세요.
npm install @logbrew/sdk @logbrew/node복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요. - 2프로젝트 만들기프로젝트 추가를 열고, 플랫폼을 선택하고, 수집 자격 증명을 복사하세요. 설정 패널은 자격 증명을 한 번만 보여 줍니다.프로젝트 추가 열기
- 3제품 액션 하나 보내기프로덕션 코드에 연결하기 전에 패키지에 포함된 예제를 실행하세요. 그러면 첫 데이터 형태를 알 수 있고 토큰도 들어가지 않습니다.
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요. - 4LogBrew에서 확인계측을 더 추가하기 전에 로그에서 첫 info 시그널을 읽으세요.
logbrew logs info --json복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.
에이전트가 앱이나 설정 명령을 수정하기 전에 공개 LogBrew 맵을 제공하세요.
curl -L https://logbrew.co/llms.txt복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.설치 프롬프트복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.
에이전트 가이드 열기https://logbrew.co/llms.txt를 읽은 다음 https://logbrew.co/en/docs#docs-sdk-choice-title에서 맞는 SDK 카드를 선택하세요. npm install @logbrew/sdk @logbrew/node는 서버 측 Node.js 서비스에만 사용하세요. Next.js, React, iOS, Android, React Native에는 선택한 카드와 프로젝트 추가 프롬프트를 사용하세요. 로그인한 사용자에게 프로젝트 추가를 열어 달라고 요청하고, 자격 증명은 해당 앱 환경에만 넣으세요. 서버 측 Node.js의 환경 변수는 LOGBREW_SERVER_API_KEY입니다. node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs는 Node 서비스에서만 실행한 다음 logbrew logs info --json으로 확인하세요. 채팅이나 커밋으로 자격 증명을 요청하지 마세요.Node.js 서비스를 설정하고 첫 텔레메트리를 확인하세요. 프로젝트 추가는 프로젝트를 만들고 수집 자격 증명을 한 번만 보여 줍니다. 아래 단계는 설치와 확인을 다룹니다.
JavaScript SDK 패키지 추가
백엔드 서비스에 로그, 요청 스팬, 액션, 릴리스, 메트릭이 필요하면 핵심 SDK와 Node 헬퍼부터 시작하세요.
npm install @logbrew/sdk @logbrew/node복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.프로젝트 추가에서 프로젝트 만들기
로그인하고, 프로젝트 추가를 열고, 플랫폼을 선택한 다음 수집 자격 증명을 복사하세요. 자격 증명은 한 번만 표시됩니다. 설정 패널을 떠나면 웹사이트에서 다시 표시되지 않습니다.
프로젝트 추가 열기첫 SDK 시그널 예제 실행
앱에 연결하기 전에 설치된 패키지 예제로 릴리스, 환경, 요청 스팬, 제품 액션, 네트워크 마일스톤, 메트릭의 형태를 살펴보세요.
node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.LogBrew에서 첫 시그널 읽기
SDK가 프로젝트 자격 증명으로 info 시그널을 보낸 후, 계측을 더 추가하기 전에 CLI나 대시보드 로그 화면에서 도착했는지 확인하세요.
logbrew logs info --json복사했습니다. 터미널이나 어시스턴트에 붙여 넣은 다음 다음 단계로 넘어가세요.
일반 텍스트
Markdown 문서 미러
에이전트나 터미널 작업에서 브라우저 전용 상태 없이 같은 문서가 필요하면 현지화된 Markdown 미러를 사용하세요.
Markdown 열기일반 텍스트
에이전트용 미러
에이전트에게 예측 가능한 공개 읽기 경로가 필요하면 llms.txt, Markdown 미러, robots, sitemap을 사용하세요.
llms.txt 열기설정
LogBrew 준비 상태 확인
먼저 status를 실행해 연결 가능 여부, 로그인 상태, 다음으로 안전하게 읽을 대상을 확인하세요.
logbrew status --json분류
최근 실패부터 시작
최근 오류 로그를 읽은 다음, 릴리스나 프로젝트에 맥락이 필요하면 이슈나 트레이스로 이동하세요.
logbrew logs error --json인계
고정된 이슈 보기 공유
동료가 같은 실패 그룹을 봐야 할 때 미해결 이슈 목록을 가져오세요.
logbrew issues open --json명령 안내
상태
비공개 데이터를 읽기 전에 로컬 인증, API 연결 가능 여부, 복구 단계를 확인하세요.
logbrew status --json명령 안내
로그
릴리스, 프로젝트, 트레이스에 맥락이 필요하면 최근 오류부터 보세요.
logbrew logs error --json명령 안내
이슈
해결, 종료, 무시, 다시 열기 중 무엇을 할지 정하기 전에 미해결 실패 그룹 목록을 확인하세요.
logbrew issues open --json명령 안내
트레이스 상세
로그나 이슈가 실패한 요청 하나를 가리키면 알고 있는 트레이스 ID로 읽으세요.
logbrew trace <trace_id> --json명령 안내
액션
중요한 맥락이 제품 액션이라면 이름으로 사용자 이벤트를 필터링하세요.
logbrew actions --name checkout_failed --json명령 안내
릴리스
배포 맥락을 로그, 이슈, 트레이스 스팬, 액션 건수와 비교하세요.
logbrew releases --jsonCLI 우선
로컬 인증과 API 연결 확인
첫 읽기에서 토큰 값을 노출하지 않고 CLI가 LogBrew API에 연결할 수 있는지 알 수 있어야 합니다.
- 스크립트나 자동화에 안정적인 필드가 필요하면 JSON 모드를 사용하세요.
- 다음 명령이 필요하면 사람이 읽는 출력을 사용하세요.
- 인증 복구는 항상 로그인과 상태 확인으로 안내하세요.
관측
리소스별로 프로덕션 시그널 읽기
질문에 답하는 시그널부터 시작하세요. 세부 정보를 열면 관련 근거를 볼 수 있습니다.
- 로그는 심각도, 릴리스, 환경, 프로젝트, 트레이스, 검색 필터를 유지합니다.
- 이슈를 조사하기 전에 상태와 마지막 발생을 확인하세요.
- 트레이스는 스팬 이름, 릴리스 맥락, 환경 맥락, 프로젝트 범위를 유지합니다.
공유
프로젝트 데이터를 노출하지 않고 유용한 맥락 보내기
누군가 설정 도움이나 안전한 인계가 필요하면 공개 문서, Markdown, 복사할 수 있는 명령을 사용하세요.
- 다음 단계가 설정이나 명령 찾기라면 문서 링크를 공유하세요.
- 스크린샷보다 일반 텍스트가 편하면 Markdown을 공유하세요.
- 비공개 프로젝트 데이터는 볼 권한이 있는 사람과만 공유하세요.
API 읽기
프로젝트와 기간 선택
지원되는 경로, 필터, 성공 및 오류 예제는 텔레메트리 API 레퍼런스를 참고하세요.
- 비공개 프로젝트 데이터를 요청하기 전에 인증하세요.
- 결과를 비교하기 전에 프로젝트와 기간을 선택하세요.
- 요청이 실패하면 반환된 복구 단계를 따르세요.
- 누락된 근거와 불러오지 못한 근거를 구분하세요.