뉴렐릭에 속성이 수집된 후 로그에서 속성을 시각적으로 추출하는 빠른 방법을 찾고 계십니까? 쿼리 시간 구문 분석을 사용하면 복잡한 정규식이나 Grok 패턴을 작성할 필요 없이 UI에서 직접 로그를 구문 분석할 수 있습니다. 쿼리 시간 구문 분석을 사용하여 로그에서 값을 일시적으로 추출하고 이러한 변수에 대한 쿼리를 빠르게 수행할 수 있습니다. 쿼리 시 구문 분석이 수행되므로 결과가 즉시 표시됩니다.
시작하려면 5분짜리 동영상을 시청하거나 아래 팁을 참조하세요.
쿼리 시간 구문 분석과 수집 구문 분석의 차이점
두 가지 유형의 구문 분석을 모두 사용하면 로그를 더 쉽게 쿼리할 수 있지만 몇 가지 중요한 차이점이 있습니다.
- 수집 구문 분석: 로그 수집 중 구문 분석에서는 Grok이나 정규식(또는 둘 다)을 사용하여 구문 분석 규칙을 생성합니다. 로그 레코드가 뉴렐릭에서 수집되면 구문 분석 규칙이 적용되어 로그 데이터와 함께 NRDB에 저장되는 영구 속성을 생성합니다. 이러한 속성을 사용하면 로그 데이터를 더 쉽게 쿼리할 수 있습니다.
- 쿼리 시간 구문 분석: 수집 구문 분석과 달리 쿼리 시간 구문 분석을 사용하면 쿼리 변수로 사용될 임시 속성을 만들 수 있습니다. 그런 다음 NRQL 쿼리에서 이러한 변수를 사용하여 로그 테이블을 채울 수 있습니다. UI에서 선택하면 쿼리가 자동으로 생성됩니다.
두 가지 구문 분석 접근 방식을 조합하여 사용하도록 선택할 수도 있습니다. 아래 표를 검토하여 쿼리 시간 구문 분석이 귀하에게 적합한지 결정하세요.
설명 | 구문 분석 수집 | 쿼리 시간 구문 분석 |
|---|---|---|
권장 사용법 | 나중에 쿼리할 수 있는 영구 속성을 생성하는 데 가장 적합합니다. | 영구적이지 않은 속성에 대해 빠른 쿼리를 수행하는 데 가장 적합합니다. |
구문 분석 언어 | Grok 패턴과 정규식을 만듭니다. | 뉴렐릭은 NRQL 분석 함수를 사용하여 쿼리를 생성합니다. |
타이밍 | 수집 시 적용 | 쿼리할 때 적용 |
결과 | 저장된 로그를 영구적으로 변경합니다. | UI에서 로그를 일시적으로 변경합니다. |
라이브 테일 로그 | 라이브 테일 로그에는 수집 구문 분석에서 추출된 값이 포함됩니다. | 라이브 테일 로그에는 쿼리 시간 구문 분석에서 추출된 값이 포함 되지 않습니다. |
내보낸 로그 | 내보낸 로그에는 수집 구문 분석에서 추출된 값이 포함됩니다. | 내보낸 로그에는 쿼리 시간 구문 분석에서 추출된 값이 포함 되지 않습니다. |
속성 수 | 수집 시 최대 255개의 속성을 사용할 수 있습니다. 수집 시 구문 분석할 수 있는 실제 숫자 속성은 로그의 특성에 따라 다릅니다. | 쿼리 시간 구문 분석을 위해 모든 규칙에서 최대 32개의 임시 속성을 구문 분석할 수 있습니다. |
쿼리 시간 구문 분석 규칙을 만드는 방법
쿼리 시간 구문 분석 규칙을 만드는 방법은 다음과 같습니다. 이 예에서는 message 속성에서 로그인 레벨 및 스크립트 메시지 값을 추출하는 방법을 보여줍니다.
구문 분석할 속성 값을 선택하세요.
구문 분석할 속성 값을 선택하여 쿼리 시간 구문 분석 규칙 생성을 시작할 수 있습니다.
로그 테이블 또는 Log details [로그 세부 정보] 보기에서 추출하려는 값이 포함된 앵커 문자열을 강조 표시합니다. 이 경우에는
level=info msg="Running script"강조표시합니다. 로그 테이블에는 다음과 같습니다.다음 사항에 유의하십시오.
- 강조 표시된 텍스트에는 추출하려는 값과 추출된 값의 위치를 식별하는 데 도움이 되는 주변 문자열 문자가 포함되어야 합니다.
- 초기 앵커 문자열이 원래 속성 값의 중간에 있는 경우 추출하려는 값 앞뒤에 문자를 하나 이상 포함하십시오.
- 전체 속성 값을 강조 표시하는 경우 추출하는 값 앞뒤의 문자에 대해 걱정할 필요가 없습니다.
- 구문 분석할 Blob 값을 강조 표시할 수 없습니다.
Create query time parsing rule [쿼리 시간 구문 분석 규칙 만들기] 옵션을 클릭합니다.
로그 테이블:
로그 세부정보 보기:
값 강조 표시 및 추출
Create query time parsing rule [쿼리 시간 구문 분석 규칙 생성을] 클릭하면 편집기에 구문 분석을 위해 선택한 문자열이 표시됩니다.
값을 추출하려면 다음을 수행합니다.
문자열 내에서 추출하려는 값을 강조 표시합니다( 값 추출 팁 참조).
Parse as [다음으로 구문 분석] 아래에 쿼리 변수로 사용될 이 임시 속성의 이름을 입력합니다.
Save [저장 을] 클릭하면 강조 표시된 값이 생성된 변수로 대체됩니다.
쿼리 시간 구문 분석 규칙 생성을 완료하세요.
값을 선택한 후 다음을 완료하세요.
편집기에서 선택한 로그에 규칙이 어떻게 적용되는지 보여주는 표 미리보기를 검토하세요.
로그를 가져오기 위해 쿼리에서 사용되는 NRQL 함수에 관심이 있다면 Query [쿼리를] 클릭하세요.
선택한 속성에서 값을 찾고 추출하는 데 사용되는 패턴 문자열은 값이 추출될 때마다 업데이트됩니다.
규칙을 생성하기 전에 변수 이름을 바꿔야 하는 경우 이름을 클릭하고 새 이름을 입력한 다음 Save [저장 을] 클릭합니다. 삭제하려는 변수를 클릭하고 Delete [삭제 를] 클릭하여 변수를 삭제할 수도 있습니다.
변수를 클릭하여 편집하거나 삭제할 수 있습니다.
변수 이름 검토 및 편집을 마친 후 Create rule [규칙 생성을] 클릭하여 규칙 생성을 완료합니다.
Log details [로그 세부 정보] 보기에서 쿼리 시간 구문 분석 규칙 생성을 시작한 경우, 해당 보기를 닫아야 로그인 테이블에서 결과를 볼 수 있습니다.
로그 세부정보
새로 추출된 값을 확인한 후 Log details [로그 세부정보] 보기를 닫습니다.
로그 테이블
로그인 테이블은 생성된 쿼리를 자동으로 새로 고치고 적용하여 로그인을 구문 분석합니다.
규칙 관리
규칙은 임시적이며 현재 사용자 세션에 적용되지만 세션 중에도 다양한 작업을 수행할 수 있습니다.