JSON 및 앱 로그

Application Logs를 쿼리 가능한 테이블로 바꾸세요.

ECS, Serilog, pino 또는 Bunyan의 JSON 라인과 일반 타임스탬프 [LEVEL] logger: message 텍스트를 지원합니다. 스택 트레이스는 이를 발생시킨 줄에 그대로 연결되므로 쓸모없는 40개 행으로 흩어지지 않습니다.

결과를 Excel, Google Sheets, AI 도구 및 Database REST API를 통한 앱에서 사용하세요.

모든 커넥터 유형을 Free에서 사용할 수 있습니다. 데이터 소스 2개와 에이전트 1개로 시작하세요.

애플리케이션 로그파일이 저장된 위치에서 읽기
네트워크 내부쿼리 스트림 네트워크 에이전트

내 머신에서 읽고, 정리하고, 쿼리하세요.

읽기 전용 쿼리 · 아웃바운드 연결

원본 파일은 제자리에 그대로 둡니다. 도구에는 쿼리 결과가 전달됩니다.

소스 → 에이전트 → 허용된 결과

Query Streams는 애플리케이션 로그를 Microsoft Excel, Google Sheets, MCP를 통한 AI 어시스턴트, REST API 및 Power BI에서 읽을 수 있는 실시간 SQL 테이블로 바꿉니다. 구조화된 JSON 라인(ECS, Serilog, pino, Bunyan)은 형식이 지정된 열로 제공되고, 일반 텍스트 로그는 문법에 따라 파싱됩니다. 중요한 차이는 여러 줄 처리 방식입니다. 스택 트레이스는 이를 발생시킨 줄에 속하며, 로그 드라이버가 이를 그대로 유지하므로 예외 하나가 서로 연결되지 않은 40개 행으로 바뀌지 않습니다. Debian과 Ubuntu에서는 dpkg 및 apt 로그도 지원하므로, 애플리케이션이 기록한 내용과 함께 시스템에서 변경된 사항도 쿼리할 수 있습니다.

  • 스택 트레이스는 한 행에 유지됩니다
  • ECS, Serilog, pino 및 Bunyan
  • dpkg 및 apt도 지원

적절한 설정으로 Application Logs를 연결하세요.

Network Agent에서 연결을 유지하세요. 다음은 Application Logs에만 해당하는 세부 정보입니다.

접는 사람
애플리케이션의 로그 디렉터리 또는 로그를 수집하는 폴더. 로컬 디스크나 \\server\share 형식의 네트워크 공유를 지정합니다(매핑된 드라이브 문자는 사용할 수 없습니다. Linux 또는 Mac에서는 먼저 마운트해야 합니다).
형식
구조화된 로거의 JSON 라인과 일반 타임스탬프 [LEVEL] logger: message 텍스트, 그리고 Debian 및 Ubuntu의 dpkg와 apt
여러 줄 처리
다음 타임스탬프가 시작되는 지점에서 레코드가 끝나므로, 스택 트레이스와 들여쓰기된 이어지는 줄은 이를 발생시킨 행에 유지됩니다.
로테이션
이름이 지정된 10가지 로테이션 패턴과 로테이션되지 않은 일반 파일을 지원합니다. 압축 아카이브도 그대로 읽습니다.
형식이 일치하지 않는 줄
events_raw_lines에 원문 그대로 보존되며, 삭제되지 않습니다.
자격 증명
없습니다. 서버가 없으며 에이전트가 파일이 있는 위치에서 파일을 읽습니다.
SQL 방언
DuckDB - 표준 SQL이므로 로거 전용 문법을 새로 배울 필요가 없습니다.

로거가 이 프로필 중 어느 것과도 일치하지 않는 형식으로 기록한다면(사내 애플리케이션에서 흔히 그렇습니다), Custom Logs 커넥터에서 한 번 설명하면 동일한 종류의 테이블로 사용할 수 있습니다. 이 페이지의 나머지 내용은 달라지지 않으며, 열 이름이 어디서 오는지만 달라집니다.

Application Logs의 작동 방식에 맞게 설계했습니다.

스택 트레이스를 그대로 연결해 유지

40줄짜리 스택 트레이스는 이벤트 하나이지 40개가 아닙니다. 줄마다 레코드로 처리하는 파서는 기본적으로 이를 잘못 처리하며, 그 결과 예외 텍스트와 이를 발생시킨 메시지가 서로 다른 행에 분리되어 연결 고리가 없는 테이블이 만들어집니다.

  • 레코드 경계는 형식의 일부이므로, 레코드는 다음 줄바꿈이 아니라 다음 타임스탬프가 시작되는 지점에서 끝납니다.
  • 전체 트레이스가 이를 발생시킨 행에 유지되므로, 예외를 유형별로 그룹화하는 작업은 재구성이 아니라 GROUP BY 한 번이면 됩니다.
  • 구조화된 로거의 필드(level, logger, message 및 JSON에 포함된 기타 항목)는 하나의 텍스트 덩어리가 아니라 열로 제공됩니다.
  • 어떤 문법에도 일치하지 않는 줄은 events_raw_lines에 원문 그대로 보관되므로, 예상하지 못한 라이브러리에서 나온 로그 줄도 조용히 사라지지 않습니다.
-- 어떤 로거에서 오류가 얼마나 자주 발생하는지 확인
SELECT   logger, level, COUNT(*) AS events
FROM     fileset.events
WHERE    level IN ('ERROR','FATAL')
GROUP BY logger, level
ORDER BY events DESC

그리고 시스템에서 변경된 사항도 확인하세요

Debian과 Ubuntu에서 dpkg 및 apt 로그는 타임스탬프와 함께 설치, 업그레이드 또는 제거된 모든 패키지를 기록합니다. 가장 흔한 장애 후속 질문에 답하기 위해 이 프로필을 제공합니다. 애플리케이션이 4시에 오류를 내기 시작했는데, 그 전에 이 컴퓨터에서 무엇이 바뀌었을까요?

형식과 동작에 대한 자세한 설명입니다.

Application Logs에 필요한 참고 자료를 여세요.

로그 폴더가 그룹화할 수 있는 테이블 형태로 변환됩니다.
핵심 아이디어

로그 폴더가 그룹화할 수 있는 테이블 형태로 변환됩니다.

grep도, 로그 스택도 아닙니다. Query Streams는 애플리케이션이 이미 기록 중인 파일을 읽고 형식을 고정한 뒤 형식이 지정된 열을 제공합니다. 따라서 “이번 주에 가장 많은 오류를 내는 로거는 무엇인가”를 오후 내내 확인할 필요 없이 쿼리 한 번으로 알아낼 수 있습니다. 파서가 읽지 못하는 줄도 조용히 버리는 대신 사유가 포함된 행으로 보관됩니다.

로그 폴더서버에서
shopfront-api/app.jsonlJSON
매장 직원/앱.log텍스트
history.log적절한

로테이션, 압축 아카이브 및 다시 읽는 파일까지 처리

가장 시끄러운 로거.sqlSQL
선택 앱, 로거,
       세다(*) AS 오류
FROM   파일셋.이벤트
어디  레벨 = '오류'
그룹 기준 앱, 로거
주문 기준 오류 DESC
결과로거에 의한 오류
앱나무꾼오류
샵프론트 API결제 클라이언트412
샵프론트 APIOrderRepo96
매장 직원이메일 발신자31
샵프론트-웹세션필터4

동일한 쿼리에서 애플리케이션 데이터베이스에 조인하세요.

앱이 이미 생성하는 파일들을 표 형식으로 보고서로 만들 수 있습니다.

앱이 그리는 도형 두 개, 상자가 그리는 도형 두 개
소스

앱이 그리는 도형 두 개, 상자가 그리는 도형 두 개

각 카드에는 Query Streams가 읽는 정확한 파일과 그 파일에서 얻을 수 있는 결과가 나와 있습니다. 이 기능을 사용하기 위해 로깅 라이브러리를 도입하거나 형식을 변경할 필요가 없습니다. 지원되는 형식은 해당 도구가 기본적으로 이미 생성하는 형식입니다.

지원되는 애플리케이션 로그

4가지 형식
Elastic 로고 - Query Streams는 Elastic 공통 스키마 JSON 애플리케이션 로그 파일을 읽습니다. JSON 라인ECS, Serilog 컴팩트, 피노, Bunyan
  • 각 줄에 하나의 JSON 객체가 있습니다. .jsonl, .ndjson 또는 *-json.log
  • ECS 필드 이름은 그대로 매핑됩니다 — 로그 레벨, 호스트 이름, 서비스 이름
  • Serilog compact, pino 및 Bunyan도 읽을 수 있습니다. 키는 같지만 철자가 다릅니다.
  • 중첩된 객체는 점선 열로 평면화되고, 매핑되지 않은 모든 것은 그 안에 배치됩니다. 데이터
  • 부록; 날짜가 표시된 회전 및 .gz 뒤따랐다
애플리케이션 로그 아이콘 - Query Streams는 스택 추적이 포함된 타임스탬프가 찍힌 텍스트 애플리케이션 로그 파일을 읽습니다. 텍스트 로그타임스탬프, 레벨, 로거, 메시지
  • 기본 모양: 스탬프, 괄호 안의 레벨, 로거, 메시지
  • 스택 트레이스는 이를 발생시킨 줄에 결합됩니다 — 40개가 아닌 한 행으로
  • at …, 원인: 그리고 추적 모두 연속으로 읽으십시오.
  • 읽기 .통나무, .밖으로 그리고 .txtJSON 파일은 선언에 의해 제외됩니다.
  • 밀리초는 쉼표 또는 점으로 구분합니다. 현지 시각은 Agent의 현지 시각으로 처리합니다.
Debian 로고 - Query Streams는 Debian 및 Ubuntu에서 dpkg 패키지 로그를 읽습니다. dpkg패키지 로그
  • 패키지 단계당 한 줄씩: 설치하다, 치받이, 제거하다, 구성
  • 패키지, 버전 그리고 새 버전 그들만의 칼럼으로
  • 상태 줄에는 dpkg가 패키지를 이동한 상태가 표시됩니다.
  • /var/log/dpkg.log 그리고 번호가 매겨져 있습니다 .gz 회전
  • 파일에 시간대가 없으면 Agent의 현지 시각으로 처리합니다.
Debian 로고 - Query Streams는 Debian 및 Ubuntu에서 apt 기록 로그를 읽습니다. 적절한기록 로그
  • 하나 키: 값 거래당 블록 수, 블록 사이에 빈 줄 표시
  • 정확한 명령줄 실행된 것과 그것이 바꾼 것
  • 시작일 이벤트 시간입니다. 종료일 별도의 칼럼으로 구성되어 있습니다.
  • 미완료된 거래는 반으로 분할되는 대신 대기합니다.
  • /var/log/apt/history.log 게다가 그것은 .gz 회전
더 많은 정보 제공이것은 시작일 뿐, 한계가 아닙니다.

에이전트 릴리스마다 새로운 애플리케이션 및 패키지 로그 형식이 추가됩니다. 에이전트는 자체적으로 최신 상태를 유지하므로, 나중에 추가된 형식은 서버를 수정하지 않고도 커넥터에 표시됩니다.

네 가지 파서는 모두 실제로 수집한 로그 파일을 기준으로 제작하고 테스트했으며, 로그 로테이션과 압축된 아카이브도 포함했습니다. 두 패키지 로그는 Debian과 Ubuntu에서만 지원됩니다. RPM 기반 배포판이나 Windows 패키지 기록용 프로필은 없습니다. 설정 중에야 이 사실을 알게 하는 것보다 미리 알려드리는 편이 낫습니다.
모든 리전에서 실행 중인 위치의 애플리케이션 로그를 읽으세요
어디를 가든

모든 리전의 애플리케이션 로그, 실행 위치를 읽어보세요

애플리케이션 하나가 서버 하나에서만 실행되는 경우는 드뭅니다. 한 클라우드 리전에는 API가, 다른 리전에는 워커가 있고, 사무실의 장비에서 계속 실행되는 것도 있습니다. 각 위치에서 Network Agent를 실행하면, 로그 파일이 있는 곳에서 파일을 읽고 Query Streams로 연결을 시작합니다. 방화벽 관점에서는 일반적인 아웃바운드 연결일 뿐입니다. 열어야 할 포트도, 구축할 VPN도, 앱에 추가해야 할 로깅 라이브러리도 없습니다.

eu-서쪽 API는 서비스별로 하나의 파일에 JSON 형식의 데이터를 작성합니다. 전화를 걸다
미국 동부 텍스트 로그, 스택 트레이스 등을 작성하는 작업자 전화를 걸다
본점 오래된 박스와 그 옆에 있는 dpkg 및 apt 설치 기록 전화를 걸다

아웃바운드 연결 세 개를 한곳에서 쿼리하세요. 인바운드 포트도, VPN도, 방화벽 변경도 필요 없습니다.

지역당 담당자 1명

Agent 하나는 로그 하나가 아니라 위치 전체를 담당합니다. 해당 위치의 JSON 라인, 텍스트 로그, 패키지 기록은 각각 같은 Agent에서 자체 File Set 커넥터가 됩니다. Free 플랜은 Agent 하나를 실행하고, 유료 플랜은 더 많이 실행합니다.

위치 1개 = 에이전트 1개 = 여러 커넥터

열 내용이 없습니다

Agent는 암호화된 아웃바운드 연결 하나를 만들고, 요청과 반환되는 행이 모두 그 연결을 통해 이동합니다. 인바운드 포트도, VPN도, 요청해야 하는 방화벽 변경도 없으며, 작동을 위해 애플리케이션에 추가할 것도 없습니다.

하나의 연결, 양방향

여러 지역에 걸친 단일 쿼리

모든 출처 연합 쿼리 각각 자체 Agent의 이름을 지정하므로, 단일 문에서 한 리전의 API 오류를 다른 리전의 워커 옆에, 또는 오류가 시작된 시점을 설명하는 패키지 기록 옆에 둘 수 있습니다. Business 및 Enterprise에 포함됩니다.

리전 2곳 → 결과 집합 1개

그들은 최신 정보를 계속 습득합니다.

에이전트는 자체적으로 업데이트되므로, 이후 릴리스에 추가된 로그 형식은 별도의 배포 없이 모든 위치에 적용됩니다. 따라서 위의 목록은 고정된 목록이 아니라 시작점에 불과합니다.

에이전트와 함께 새로운 형식들이 등장합니다.

스택 트레이스, 클록 및 유사 항목
어려운 부분

스택 트레이스, 클록 및 유사 항목

애플리케이션 로그 파일은 서버에서 가장 복잡한 파일입니다. 하나의 이벤트가 40줄에 걸쳐 발생할 수 있고, 서로 관련 없는 두 가지 형식이 동일하게 보일 수 있으며, 이러한 파일의 절반은 시간대 정보가 전혀 없습니다. 이러한 문제들은 추측에 의존하는 것이 아니라 명확하게 선언하여 처리합니다.

하나의 사건, 40줄이 아니라.

타임스탬프로 시작하지 않는 줄은 바로 위 줄에 속합니다. 이것이 스택 트레이스가 수십 개의 조각으로 쪼개지지 않고 해당 스택 트레이스를 발생시킨 메시지에 연결된 상태로 유지되는 이유입니다. 그룹 기준 다시 조립할 수 있습니다.

연속된 줄 → 최대 200줄까지 결합

비슷하게 생긴 두 개의 통나무

JSON 애플리케이션 라인, Docker 래퍼, 웹 서버의 JSON 액세스 라인은 모두 “타임스탬프가 포함된 JSON”입니다. 형식은 라인의 내용에 따라 결정되므로, 각 라인은 별도의 프로필로 처리됩니다. 파일 이름을 기준으로 분기하지 않습니다.

파일 이름이 아니라 내용이 결정합니다.

시간대가 없는 시계

텍스트 로그, dpkg, apt는 모두 오프셋을 붙이지 않고 호스트의 현지 시간을 기록합니다. 추측하는 대신, 해당 프로필은 타임스탬프가 현지 시간임을 선언하고 Agent의 시간대로 읽습니다. 어느 경우든 원래 문자열은 별도의 열에 보존됩니다.

현지 시계 → 추론하지 않고 명시적으로 선언

거래가 아직 진행 중입니다

apt는 업그레이드의 시작 부분을 즉시 기록하고, dpkg가 완료될 때까지 (몇 분 정도 걸릴 수 있음) 마지막 줄을 기록하지 않습니다. 아직 완료되지 않은 블록은 절반으로 잘려서 시작 부분이 없는 이벤트로 나타나는 대신, 대기합니다.

종료일을 최대 30분 동안 기다립니다.

파일에서5줄
2026-09-08 14:02:11,431 [오류] PaymentClient: 결제 실패 java.net.SocketTimeoutException: 읽기 시간 초과 java.base/java.net.SocketInputStream.read에서 PaymentClient.charge(PaymentClient.java:88)에서 … 그 외 24개
표에서1줄
이벤트 시간
2026-09-08 14:02:11.431
수준
오류
나무꾼
결제 클라이언트
메시지
청구 실패 ↵ java.net.SocketTimeoutException: Read timed out ↵ at …
예외 발생 횟수를 세지, 예외가 출력한 줄 수를 세지 마십시오.
실제로 얻게 되는 열
스키마

실제로 얻게 되는 열

타임스탬프가 옆에 붙은 텍스트 덩어리가 아닙니다. 각 형식은 직접 필터링하고 그룹화하고 집계할 수 있는 유형 지정 열로 파싱됩니다. 애플리케이션 로그가 구조화된 JSON을 사용하는 경우 자체 필드도 풀어서 열로 만듭니다.

탄성 로고
JSON 라인ECS · Serilog · pino · Bunyan
수준나무꾼메시지주인서비스개울데이터
애플리케이션 로그 아이콘
텍스트 로그스택 트레이스가 병합되었습니다.
수준나무꾼메시지
데비안 로고
dpkg 패키지 로그Debian · Ubuntu
행동상태패키지버전새 버전세부 사항
데비안 로고
apt 기록 로그거래당 하나의 블록
명령줄요청자설치하다치받이제거하다숙청오류종료일데이터

각 행에는 또한 다음이 포함됩니다. 이벤트 시간로그가 읽힌 원본 스탬프와 해당 로그가 나온 파일로 식별됩니다. 애플리케이션 로그는 다음과 같은 정보로 식별됩니다. 앱 그리고 두 개의 패키지 로그는 다음과 같습니다. 주인 — 둘 다 파일이 있는 폴더에서 가져오므로, 서비스별 또는 머신별 폴더를 사용하면 그룹화에 적합한 열이 만들어집니다. 텍스트 로그의 열이 세 개인 데는 이유가 있습니다. 자유 형식 메시지에 안정적으로 존재하지 않는 필드를 추측하는 대신, 스택 트레이스를 포함한 메시지 전체를 그대로 보존합니다.

이것이 의도적으로 하지 않는 것은 무엇인가

이것이 의도적으로 하지 않는 것은 무엇인가

이는 실시간 로그 추적이 아닙니다. 쿼리 스트림은 쿼리를 실행할 때 디스크에 저장된 파일을 그대로 읽어오기 때문에 오류 발생 시 로그가 스트림 형태로 표시되는 것이 아니라 행 단위로 표시됩니다. 출력되는 모든 줄에 대해 초 단위 미만의 알림을 받아야 하는 경우에는 로그 파이프라인이 적합하며, 이 경우 해당 사항을 안내해 드릴 것입니다.

애플리케이션 로그에는 애플리케이션이 출력하는 내용이 무엇이든 들어갑니다. 이 점은 분명히 짚고 넘어갈 필요가 있습니다. 토큰, 고객 이메일 또는 전체 요청 본문을 기록하면 그 문자열은 이미 파일에 있으며 해당 열에도 들어갑니다. 웹 서버 로그와 달리 제외할 필드 맵은 없습니다. 결과 테이블을 파일과 똑같이 신중하게 다루세요.

패키지 로그에 기록될 수 있는 내용 중 일부는 캡처를 통해 입증되는 것이 아니라 형태를 통해 식별됩니다. dpkg는 구성 파일의 한 줄을 문서화합니다. 숙청 그리고 사라지다 행동; 적절한 문서 요청자, 오류, 숙청, 재설치 그리고 다운그레이드. 이 프로필을 구축할 때 사용한 로그에는 그중 어느 것도 나타나지 않았으므로, 이를 선언한 것이지 실제로 확인해 보인 것은 아닙니다. 또한 두 패키지 로그 프로필 모두 RPM 기반 배포판이나 Windows를 지원하지 않습니다.

제한 사항이라기보다는 설정상의 한 가지 세부 사항입니다. ID 열은 지정한 폴더 아래에 있는 파일이 위치한 폴더의 이름을 가져옵니다. 서비스 또는 머신별로 하위 폴더가 하나씩 있는 디렉터리를 커넥터로 지정하면 유용한 이름을 자동으로 얻을 수 있지만, 여러 개의 파일이 흩어져 있는 디렉터리를 직접 지정하면 모든 행의 이름이 해당 디렉터리 이름으로 지정됩니다. 설정할 때 30초 정도만 투자하면 됩니다.

나머지는 일반적인 설계 방식을 따릅니다. 에이전트는 외부 연결을 통해 파일을 읽습니다. 애플리케이션과 함께 설치되는 것은 없으며, 데이터를 다시 기록하는 것도 없고, 프로세스에 연결되거나 계측되는 것도 없으며, 접근은 읽기 전용입니다.

연결부터 유용한 결과까지.

  1. 애플리케이션's 로그 폴더를 볼 수 있는 위치, 즉 앱 서버, 컨테이너 호스트 또는 로그를 수집하는 공유 위치에 Network Agent를 설치하세요.
  2. 커넥터가 해당 위치를 가리키도록 설정하고 프로필을 선택하세요. 구조화된 로거에는 JSON 라인을, 타임스탬프 [LEVEL] 로거: 메시지 레이아웃에는 일반 텍스트 프로필을 사용하세요.
  3. 여러 줄 레코드는 운에 맡기는 대신 레코드 경계로 처리합니다. 타임스탬프가 시작되는 위치에서 새 레코드가 시작되므로 들여쓰기된 스택 트레이스도 해당 라인에 계속 연결됩니다.
  4. 동기화할 때마다 새로 추가된 바이트만 읽고 로그 로테이션도 따라가므로, 로그가 많은 서비스라고 해서 매일 비용이 더 들지 않습니다.
  5. 쿼리해 보세요. 로거별 오류율, 유형별 예외 그룹화, 또는 서비스 전반에 걸친 단일 요청 ID 추적이 가능합니다.

Application Logs 결과를 활용해 보세요.

하나의 연결로 스프레드시트, 앱, AI 도구를 사용할 수 있습니다. 저장된 쿼리를 실행할 권한을 공유하세요. 수신자는 허용된 결과만 볼 수 있으며 SQL과 소스 로그인 정보는 숨겨집니다.

귀사 팀, 협력업체 및 파트너 여러분께

실시간 Application Logs 결과를 워크시트로 바로 가져오고 필요할 때 새로 고치세요. 데스크톱 Excel, Excel Online, Microsoft 365에서 사용할 수 있습니다.

Excel 살펴보기

동료, 공급업체, 파트너 등 누구와도 실시간 Application Logs 결과를 공유하세요. 북마크할 수 있는 그리드로 제공되며, 휴대폰, 태블릿, 데스크톱에서 열 때마다 최신 결과를 다시 가져옵니다. 상대방에게는 결과만 보이고 SQL이나 파일은 보이지 않습니다.

데이터 뷰어 작동 방식

앱 및 시스템용

Application Logs 쿼리를 인증된 JSON 엔드포인트로 게시하면 모든 애플리케이션에서 호출할 수 있습니다. OpenAPI 3.1 사양과 바로 사용할 수 있는 Postman, Insomnia, Hoppscotch 컬렉션도 제공됩니다. 데이터베이스 포트를 열지 않습니다.

REST API 살펴보기

생성된 Power Query M을 Power BI 고급 편집기에 붙여넣으면 보고서에서 HTTPS를 통해 실시간 Application Logs 결과를 읽습니다. ODBC 드라이버도, 열어 둔 데이터베이스 포트도 필요하지 않습니다.

Power BI 살펴보기

AI 도구의 경우

AI 어시스턴트에 올바른 SQL을 작성하는 데 필요한 스키마와 함께 Application Logs에 대한 읽기 전용 액세스 권한을 제공하세요. 채팅에 자격 증명을 넣을 필요가 없습니다.

MCP 살펴보기

사람들에게 전달됨

Application Logs를 나머지 데이터와 조인하세요.

데이터베이스, 비즈니스 API, 파일, 로그를 하나의 읽기 전용 쿼리로 가져오세요. 모든 커넥터에서 페더레이션 쿼리를 지원합니다.

연결과 테이블의 이름을 지정하세요. Query Streams가 소스 쿼리를 처리하고 결과를 결합합니다.

페더레이션 쿼리 살펴보기
소스 간 쿼리 예시
-- 아무것도 복사되지 않았고, 아무것도 병합되지 않았으며, 아무것도 예약되지 않았습니다.
선택   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
FROM     applogs.fileset.orders1  f
JOIN     pg_crm.공개.고객2 c ON c.id = f.customer_id
JOIN     청구.stripe.invoices3 i ON i.customer = c.stripe_id
그룹 기준 c.지역
주문 기준 청구서 발행 DESC;

사용자 연결, 스키마, 테이블 및 열 이름을 사용하세요.

커넥터 제품군 전반에 공통으로 적용됩니다.

모든 로그 커넥터는 다음 항목도 제공합니다.

  • events — 파싱된 각 줄을 한 행으로 제공하며, 타임스탬프, 문법에 지정된 필드, 해당 줄이 들어 있던 파일을 나타내는 _source_file을 포함합니다.
  • events_raw_lines — 문법에 일치하지 않은 줄을 버리지 않고 원문 그대로 보관합니다. 예상하지 못한 형식도 여전히 쿼리로 답을 찾을 수 있습니다.
  • files_current 및 files_events — 현재 파일 목록과 감사 추적 정보입니다. 어떤 파일이 나타났고, 로테이션되었고, 사라졌는지, 또 보류된 항목이 있는지와 파일명 및 사유를 보여 줍니다.
  • 회전을 우회하는 대신 이해합니다 — 이름이 지정된 회전 패턴 10가지와 회전되지 않은 일반 파일을 지원하므로, 어제의 로그와 압축 아카이브도 오늘의 로그와 동일한 테이블로 조회할 수 있습니다.

알아두면 좋겠네요.

  • 읽기 전용이 강제됩니다 — 한 번에 하나의 문장만 실행하며 SELECT와 관련 문장만 허용됩니다. 당사는 로그를 쓰거나, 이동하거나, 회전하거나, 잘라내지 않습니다.
  • 업로드되는 항목은 없습니다 — 에이전트 옆의 사용자 컴퓨터에서 로그 행을 파싱하고 암호화된 상태로 캐시합니다. 쿼리 결과만 네트워크 밖으로 나갑니다.
  • 새 바이트만 읽습니다 — 에이전트는 파일을 다시 읽는 대신 각 파일에서 이전에 읽은 위치부터 계속 처리하므로, 로그가 바쁘게 기록되어도 매일 추가 비용이 발생하지 않습니다.
  • SQL 방언은 DuckDB입니다. 다른 커넥터에서 작성하는 SQL과 동일합니다.

애플리케이션 로그 관련 질문

Application Logs 쿼리 결과는 어디에서 사용할 수 있나요?

Application Logs 결과는 Excel, Google Sheets, Data Viewer, Database REST API를 통한 앱, MCP 또는 Nova를 통한 AI 도구에서 사용할 수 있습니다. 저장된 결과는 지원되는 Automation 대상, 보고서, 알림에도 제공됩니다. 대상 사용 가능 여부와 이용 한도는 요금제에 따라 다릅니다.

Application Logs를 사용하려면 인바운드 포트를 열어야 하나요?

아니요. Application Logs에 연결할 수 있는 머신에 Network Agent를 설치하세요. 에이전트는 아웃바운드로 Query Streams에 연결하므로 인바운드 포트나 VPN이 필요하지 않습니다. 다만 소스 자체의 액세스 규칙에 따라 에이전트 머신의 연결을 허용해야 합니다.

Application Logs 파일이 업로드되나요?

Network Agent는 파일이 있는 위치에서 파일을 읽고 에이전트 머신에 캐시를 보관합니다. 원본 파일은 업로드되거나 이동되거나 다시 쓰이지 않습니다. 요청된 쿼리 결과만 아웃바운드 암호화 연결을 통해 네트워크 밖으로 전송됩니다.

Application Logs를 연결하려면 무엇이 필요한가요?

폴더: 애플리케이션의 로그 디렉터리 또는 로그를 수집하는 폴더입니다. 로컬 디스크나 \\server\share 형식으로 입력한 네트워크 공유를 사용할 수 있습니다(매핑된 드라이브 문자는 사용할 수 없으며, Linux 또는 Mac에서는 먼저 마운트해야 합니다). 형식: 구조화된 로거의 JSON Lines와 일반 타임스탬프 [LEVEL] 로거: 메시지 텍스트 형식이며, Debian 및 Ubuntu에서는 dpkg와 apt도 지원합니다. 여러 줄: 다음 타임스탬프가 시작되는 지점에서 레코드가 끝나므로, 스택 추적과 들여쓰기된 후속 행은 해당 오류를 발생시킨 행에 포함됩니다. 순환: 이름이 지정된 순환 패턴 10가지와 순환되지 않은 일반 파일을 지원하며, 압축된 아카이브도 제자리에서 읽습니다.

Application Logs를 다른 연결된 소스와 조인할 수 있나요?

예. 페더레이션 쿼리는 데이터베이스, 비즈니스 API, 파일, 로그를 포함한 모든 커넥터 유형을 지원합니다. 하나의 읽기 전용 쿼리에서 연결과 테이블의 이름을 지정하세요. Query Streams가 필요에 따라 각 소스에 맞게 쿼리를 변환하고 결과를 결합합니다. 페더레이션 쿼리 작동 방식 알아보기.

어떤 로깅 라이브러리를 사용해야 하나요?

특별히 필요한 것은 없습니다. JSON Lines를 작성한다면 Elastic Common Schema 필드 이름이 그대로 매핑됩니다. Serilog의 compact 형식, pino, Bunyan도 최상위 키는 같고 표기만 다르므로 읽을 수 있습니다. 타임스탬프는 해당 행에 실제로 포함된 일반적인 이름 중 하나에서 가져옵니다.

일반 텍스트를 작성하면, 보통은 타임스탬프 [레벨] 로거: 메시지 shape는 그 자체로 지원되는 형식입니다. 채택하거나 재구성할 필요가 없습니다.

스택 트레이스에는 실제로 어떤 일이 발생하나요?

해당 오류를 발생시킨 레코드에 포함됩니다. 타임스탬프로 시작하는 행에서 레코드가 시작되고, 타임스탬프로 시작하지 않는 그 뒤의 모든 행은 해당 레코드의 연속 행으로 처리됩니다. Java, .NET 또는 Python의 트레이스가 바로 이런 형태입니다. 예외 클래스는, 그 at … 프레임, 원인: 체인과 파이썬 추적 헤더는 모두 위쪽 줄에 속하는 것으로 인식됩니다.

실질적인 차이점은 오류를 세는 것은 오류를 정확하게 세는 것임을 의미합니다. 이 기능이 없으면 예외 하나가 발생하면 해당 예외가 출력한 프레임 수만큼 수치가 부풀려지고, 실제로 읽고 싶은 메시지는 클래스 이름과 다른 행에 나타나게 됩니다.

dpkg와 apt가 애플리케이션 로그에 포함되는 이유는 무엇인가요?

“언제부터 문제가 발생했나요?”라는 질문 다음에 바로 묻게 되는 “무엇이 바뀌었나요?”라는 질문에 답해 주기 때문입니다. 패키지 관리자가 직접 기록하는 로그이며, 같은 폴더 트리에 있고 같은 방식으로 읽힙니다. 오류 로그와 함께 볼 때 가장 유용한 자료입니다.

apt의 기록은 읽기 쉬운 형식입니다. 트랜잭션마다 하나의 블록으로 기록되며, 실행된 정확한 명령과 설치, 업그레이드 또는 제거된 항목이 포함됩니다. dpkg 로그는 더 세밀하며 패키지 단계마다 한 행씩 기록됩니다. 두 로그를 함께 보면 변경 사항을 기억에 의존하지 않고 날짜와 연결할 수 있습니다.

제가 겪고 있는 오류를 오류가 발생한 업그레이드 과정과 연관시킬 수 있을까요?

네, 다만 한 가지 알아두셔야 할 점은 커넥터는 한 가지 형식만 읽으므로 애플리케이션 로그와 /var/log/apt/history.log 커넥터가 하나가 아니라 두 개입니다. 연합 쿼리는 단일 명령문으로 이들을 결합하는데, 이는 로그를 프로덕션 데이터베이스에 연결하는 것과 동일한 메커니즘입니다.

이 로그 계열을 활용해 만들 만한 쿼리는 바로 이것입니다. 시간별 오류 수와 그날 실행된 트랜잭션을 나란히 확인하는 것입니다. 둘 다 어디에도 전송할 필요가 없었던 파일에서 읽어 옵니다.

이거 실시간인가요?

스트리밍 방식이 아니라 필요할 때 실행됩니다. 쿼리가 실행될 때 파일의 현재 내용이 읽히므로 애플리케이션이 새 행을 기록하고 파일이 수집되면 결과에 나타납니다. 매일 밤 정해진 시간에만 실행되는 것은 아니지만, 실시간으로 계속 추적하는 방식도 아닙니다.

지난 몇 주 동안의 질문을 하고 그 답을 스프레드시트나 예정된 보고서로 받아보는 데 있어서, 그것은 통나무 더미보다 훨씬 효율적이고 기계적인 과정도 훨씬 간소화된 유용한 방식입니다.

제 로그에는您께서 나열하신 필드가 없습니다. 혹시 그 필드들이 손실된 건가요?

아니요. JSON 및 apt 형식에서는 명명된 열에 매핑되지 않는 모든 데이터는 별도의 공간에 저장됩니다. 데이터 삭제되는 대신 열로 유지되므로 요청 ID, 테넌트 또는 기록된 기간은 여전히 쿼리할 수 있습니다. 중첩된 객체는 입력 시 점으로 구분된 이름으로 평탄화됩니다.

고정된 형식과 전혀 일치하지 않는 행도 보존됩니다. 원시 행으로 저장되고 사유가 함께 표시되므로, 예상치 못한 형식 변경이 수치에 조용히 누락되는 대신 눈에 보이는 항목으로 나타납니다.

Red Hat, Fedora 또는 Alpine 패키지의 이력은 어떻습니까?

해당 프로필이 없습니다. dnf, 맛있어요 또는 apk 오늘 현재 Windows에 해당하는 기능은 없습니다. 여기서 지원하는 두 가지 패키지 형식은 dpkg 로그와 apt 기록이며, Debian 및 Ubuntu를 지원합니다.

이러한 제한은 애플리케이션 자체 로그에는 영향을 주지 않습니다. JSON 및 텍스트 형식은 어떤 배포판에서 사용되는지와 관계없이 처리됩니다. 폴더가 어떤 형식으로 인식될지 확실하지 않다면, 연결 테스트를 통해 설정을 확정하기 전에 감지된 내용을 확인할 수 있습니다.

작업이 이루어지는 곳에 Application Logs를 배치하세요.

Free로 시작하세요. 모든 커넥터 유형, 데이터 소스 2개, Network Agent 1개를 이용할 수 있습니다. 필요에 따라 요금제 이용 한도를 추가하세요.