# LogBrew 텔레메트리 설정 앱이나 프레임워크를 선택하고, 프로젝트를 만들고, 안전한 시그널 하나를 확인하세요. # 플랫폼 선택 텔레메트리를 보낼 앱이나 프레임워크를 선택하세요. 프로젝트 추가에서도 같은 항목을 선택하세요. ## Node.js 서비스 백엔드 서비스에 로그, 요청 스팬, 액션, 릴리스, 메트릭이 필요하면 Node.js 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Node 첫 시그널 경로 사용 ## Express 서비스 Node 서비스가 Express 미들웨어로 요청을 처리하면 Express 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: 프로젝트 추가 열기 ## Fastify 서비스 Node 서비스가 Fastify 플러그인으로 라우트를 처리하면 Fastify 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: 프로젝트 추가 열기 ## JavaScript 앱 제품 액션, 로그, 가벼운 클라이언트 시그널을 보내는 프런트엔드 페이지에는 JavaScript 브라우저 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: 프로젝트 추가 열기 ## Next.js 앱 라우트, 서버 렌더링, 클라이언트 액션을 한 번에 설정하려면 Next.js 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: 프로젝트 추가 열기 ## React 앱 사용자 액션과 UI 상태를 보내는 컴포넌트 기반 웹 앱에는 React 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: 프로젝트 추가 열기 ## Angular 앱 프레임워크 라우팅과 앱 오류를 한 번에 설정하려면 Angular 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: 프로젝트 추가 열기 ## Vue 앱 명확한 제품 액션과 브라우저 측 시그널이 필요한 Vue 앱에는 Vue 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: 프로젝트 추가 열기 ## Svelte 앱 SDK를 바로 설치하려는 Svelte 앱에는 Svelte 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: 프로젝트 추가 열기 ## NestJS 서비스 Node 서비스가 Nest 모듈과 요청 처리 중심으로 구성되어 있으면 NestJS 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: 프로젝트 추가 열기 ## Python 서비스 Python 워커와 서비스는 핵심 패키지부터 시작하세요. ```bash python3 -m pip install logbrew-sdk ``` Next: 프로젝트 추가 열기 ## Django 앱 Django 프로젝트의 요청 및 앱 시그널에는 Django 패키지를 사용하세요. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: 프로젝트 추가 열기 ## FastAPI 서비스 요청 스팬과 액션을 명시적으로 보내는 Python API에는 FastAPI 패키지를 사용하세요. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: 프로젝트 추가 열기 ## .NET 서비스 서비스가 서버 측 시그널을 직접 보낸다면 .NET 패키지를 설치하세요. ```bash dotnet add package LogBrew ``` Next: 프로젝트 추가 열기 ## ASP.NET Core 앱 .NET 요청 처리와 웹 앱 시그널을 한 번에 설정하려면 ASP.NET Core 패키지를 사용하세요. ```bash dotnet add package LogBrew.AspNetCore ``` Next: 프로젝트 추가 열기 ## Java 서비스 앱에서 직접 만드는 로그, 요청 스팬, 제품 액션이 필요한 Java 서비스에는 JVM 패키지를 사용하세요. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: 프로젝트 추가 열기 ## Go 서비스 서비스가 로그, 스팬, 메트릭, 트레이스 맥락을 명시적으로 다룬다면 Go 패키지를 추가하세요. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: 프로젝트 추가 열기 ## PHP 앱 PHP 서비스와 앱에서 직접 만드는 요청 시그널에는 Composer를 사용하세요. ```bash composer require logbrew/sdk ``` Next: 프로젝트 추가 열기 ## Ruby 서비스 앱과 요청 시그널을 명시적으로 보내야 하는 Ruby 서비스에는 Ruby gem을 사용하세요. ```bash gem install logbrew-sdk ``` Next: 프로젝트 추가 열기 ## Rust 서비스 로그, 스팬, 액션, 메트릭을 직접 만드는 서비스에는 Rust crate를 추가하세요. ```bash cargo add logbrew ``` Next: 프로젝트 추가 열기 ## iOS 앱 제품 시그널을 명시적으로 보내는 iOS 앱에는 Apple 플랫폼 패키지를 사용하세요. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: 프로젝트 추가 열기 ## Android 앱 Android 런타임에서 앱이 직접 만든 시그널을 보내는 앱에는 Android 패키지를 사용하세요. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: 프로젝트 추가 열기 ## React Native 앱 JavaScript 제품 액션을 공유하는 모바일 앱에는 React Native 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: 프로젝트 추가 열기 ## Unity 앱 제품 액션과 런타임 시그널을 보내는 게임이나 시뮬레이션에는 Unity 패키지를 사용하세요. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: 프로젝트 추가 열기 ## C 앱 시그널을 직접 제어해야 하는 네이티브 서비스나 임베디드 앱에는 C 소스를 사용하세요. ```bash cc -std=c99 -Wall -Wextra -Wpedantic -Iinclude src/logbrew.c src/logbrew_metric.c src/logbrew_recording_transport.c src/logbrew_timeline.c src/logbrew_trace.c your_app.c -o your_app ``` Next: 프로젝트 추가 열기 ## C++ 앱 CMake 3.16 이상의 C++17 프로젝트에서 릴리스된 CLI 계획을 실행하세요. LogBrew::LogBrew를 링크하세요. 호스팅 전송이 필요할 때만 LogBrew::HttpTransport와 libcurl을 활성화하세요. ```bash logbrew setup --json ``` Next: 프로젝트 추가 열기 ## 설정 과정 한눈에 보기 이 순서를 따르면 설정 흐름을 벗어나지 않고 문서에서 확인된 제품 액션까지 갈 수 있습니다. - 설치. 패키지 추가: 런타임에 맞는 SDK 패키지부터 시작하세요. - 생성. 프로젝트 만들기: 프로젝트 추가를 열고 프로젝트 자격 증명을 복사하세요. 한 번만 표시됩니다. - 전송. 제품 액션 하나 보내기: 앱에 연결하기 전에 비밀 정보가 없는 제품 액션을 하나 실행하세요. - 확인. 로그 확인: 로그나 CLI로 시그널을 확인하세요. # 첫 SDK 실행 성공하기 첫 세션은 간단하게 하세요. 패키지를 설치하고, 프로젝트를 만들고, 비밀 정보가 없는 제품 액션을 하나 보낸 다음 LogBrew에서 확인하세요. ## 첫 시그널 설정에 필요한 것 SDK가 직접 수집 API로 보내므로 설정 과정이 짧습니다. - 수집기: 로컬 에이전트 없음. SDK 패키지를 설치하고 LogBrew API로 바로 보내세요. - 자격 증명: 프로젝트 자격 증명 하나. 해당 프로젝트를 만들거나 설정할 때만 프로젝트 추가에서 복사하세요. - 확인: 로그에서 확인. info 시그널을 하나 보내고, 계측을 넓히기 전에 확인하세요. ## AI 어시스턴트용 맥락 에이전트가 앱이나 설정 명령을 수정하기 전에 공개 LogBrew 맵을 제공하세요. ```bash curl -L https://logbrew.co/llms.txt ``` ### 설치 프롬프트 ```bash 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으로 확인하세요. 채팅이나 커밋으로 자격 증명을 요청하지 마세요. ``` Next: 에이전트 가이드 열기 ## SDK 설치 로그, 스팬, 액션, 릴리스, 메트릭이 필요한 백엔드 서비스에는 Node 패키지를 사용하세요. ```bash npm install @logbrew/sdk @logbrew/node ``` ## 프로젝트 만들기 프로젝트 추가를 열고, 플랫폼을 선택하고, 수집 자격 증명을 복사하세요. 설정 패널은 자격 증명을 한 번만 보여 줍니다. Next: 프로젝트 추가 열기 ## 제품 액션 하나 보내기 프로덕션 코드에 연결하기 전에 패키지에 포함된 예제를 실행하세요. 그러면 첫 데이터 형태를 알 수 있고 토큰도 들어가지 않습니다. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## LogBrew에서 확인 계측을 더 추가하기 전에 로그에서 첫 info 시그널을 읽으세요. ```bash logbrew logs info --json ``` # 첫 Node SDK 시그널을 LogBrew로 보내기 Node.js 서비스를 설정하고 첫 텔레메트리를 확인하세요. 프로젝트 추가는 프로젝트를 만들고 수집 자격 증명을 한 번만 보여 줍니다. 아래 단계는 설치와 확인을 다룹니다. ## JavaScript SDK 패키지 추가 백엔드 서비스에 로그, 요청 스팬, 액션, 릴리스, 메트릭이 필요하면 핵심 SDK와 Node 헬퍼부터 시작하세요. ```bash npm install @logbrew/sdk @logbrew/node ``` ## 프로젝트 추가에서 프로젝트 만들기 로그인하고, 프로젝트 추가를 열고, 플랫폼을 선택한 다음 수집 자격 증명을 복사하세요. 자격 증명은 한 번만 표시됩니다. 설정 패널을 떠나면 웹사이트에서 다시 표시되지 않습니다. ## 첫 SDK 시그널 예제 실행 앱에 연결하기 전에 설치된 패키지 예제로 릴리스, 환경, 요청 스팬, 제품 액션, 네트워크 마일스톤, 메트릭의 형태를 살펴보세요. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## LogBrew에서 첫 시그널 읽기 SDK가 프로젝트 자격 증명으로 info 시그널을 보낸 후, 계측을 더 추가하기 전에 CLI나 대시보드 로그 화면에서 도착했는지 확인하세요. ```bash logbrew logs info --json ``` # 경로 선택 ## LogBrew 준비 상태 확인 먼저 status를 실행해 연결 가능 여부, 로그인 상태, 다음으로 안전하게 읽을 대상을 확인하세요. ```bash logbrew status --json ``` ## 최근 실패부터 시작 최근 오류 로그를 읽은 다음, 릴리스나 프로젝트에 맥락이 필요하면 이슈나 트레이스로 이동하세요. ```bash logbrew logs error --json ``` ## 고정된 이슈 보기 공유 동료가 같은 실패 그룹을 봐야 할 때 미해결 이슈 목록을 가져오세요. ```bash logbrew issues open --json ``` # 명령 안내 ## 상태 비공개 데이터를 읽기 전에 로컬 인증, API 연결 가능 여부, 복구 단계를 확인하세요. ```bash logbrew status --json ``` ## 로그 릴리스, 프로젝트, 트레이스에 맥락이 필요하면 최근 오류부터 보세요. ```bash logbrew logs error --json ``` ## 이슈 해결, 종료, 무시, 다시 열기 중 무엇을 할지 정하기 전에 미해결 실패 그룹 목록을 확인하세요. ```bash logbrew issues open --json ``` ## 트레이스 상세 로그나 이슈가 실패한 요청 하나를 가리키면 알고 있는 트레이스 ID로 읽으세요. ```bash logbrew trace --json ``` ## 액션 중요한 맥락이 제품 액션이라면 이름으로 사용자 이벤트를 필터링하세요. ```bash logbrew actions --name checkout_failed --json ``` ## 릴리스 배포 맥락을 로그, 이슈, 트레이스 스팬, 액션 건수와 비교하세요. ```bash logbrew releases --json ``` ## 로컬 인증과 API 연결 확인 첫 읽기에서 토큰 값을 노출하지 않고 CLI가 LogBrew API에 연결할 수 있는지 알 수 있어야 합니다. - 스크립트나 자동화에 안정적인 필드가 필요하면 JSON 모드를 사용하세요. - 다음 명령이 필요하면 사람이 읽는 출력을 사용하세요. - 인증 복구는 항상 로그인과 상태 확인으로 안내하세요. ## 리소스별로 프로덕션 시그널 읽기 질문에 답하는 시그널부터 시작하세요. 세부 정보를 열면 관련 근거를 볼 수 있습니다. - 로그는 심각도, 릴리스, 환경, 프로젝트, 트레이스, 검색 필터를 유지합니다. - 이슈를 조사하기 전에 상태와 마지막 발생을 확인하세요. - 트레이스는 스팬 이름, 릴리스 맥락, 환경 맥락, 프로젝트 범위를 유지합니다. ## 프로젝트 데이터를 노출하지 않고 유용한 맥락 보내기 누군가 설정 도움이나 안전한 인계가 필요하면 공개 문서, Markdown, 복사할 수 있는 명령을 사용하세요. - 다음 단계가 설정이나 명령 찾기라면 문서 링크를 공유하세요. - 스크린샷보다 일반 텍스트가 편하면 Markdown을 공유하세요. - 비공개 프로젝트 데이터는 볼 권한이 있는 사람과만 공유하세요. ## 프로젝트와 기간 선택 지원되는 경로, 필터, 성공 및 오류 예제는 텔레메트리 API 레퍼런스를 참고하세요. - 비공개 프로젝트 데이터를 요청하기 전에 인증하세요. - 결과를 비교하기 전에 프로젝트와 기간을 선택하세요. - 요청이 실패하면 반환된 복구 단계를 따르세요. - 누락된 근거와 불러오지 못한 근거를 구분하세요. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/ko/docs - Docs Markdown: https://logbrew.co/ko/docs.md - Agent guide: https://logbrew.co/ko/agents - Home Markdown: https://logbrew.co/ko/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml