GraphQL 로그 읽기
우리는 GraphQL 쿼리 로그를 필터링하기 위해 Kibana를 사용합니다. @gitlab.com 이메일 주소로 Kibana에 로그인하세요.
Kibana에서는 두 가지 종류의 GraphQL 로그를 검토할 수 있습니다:
- 요청 내에서 실행된 각 GraphQL 쿼리의 로그.
- 쿼리 멀티플렉싱으로 인해 여러 쿼리가 실행될 수 있는 전체 요청의 로그.
각 GraphQL 쿼리의 로그
multiplex 쿼리에서 각 개별 쿼리는 별도로 로깅됩니다. 이러한 로그를 검사하기 위해 서브컴포넌트 필터링을 사용할 수 있습니다. 이 필터가 활성화된 Kibana로 이동하거나 이러한 단계를 따라 서브컴포넌트 필터를 설정하세요:
- 필터 추가:
- 필터:
json.subcomponent - Operator:
is - Value:
graphql_json
- 필터:
- 새로 고침(Refresh) 선택.
사이드바의 Available fields 섹션에서 Kibana 필드를 선택하여 로그 테이블에 열을 추가하거나 이 뷰를 방문하여 이미 선택된 Kibana 필드 세트를 확인할 수 있습니다. 몇 가지 관련된 Kibana 필드는 다음과 같습니다:
| Kibana 필드 | 설명 |
|---|---|
json.operation_name
| 클라이언트가 사용한 operation name입니다. |
json.operation_fingerprint
| 쿼리의 지문으로, 시간이 지남에 따라 반복되는 쿼리를 인식하는 데 사용됩니다. |
json.meta.caller_id
| GitLab 프론트엔드에서 온 쿼리의 경우 graphql:<operation_name>로 표시되며, 그렇지 않으면 graphql:unknown로 표시됩니다. 내부 쿼리와 외부 쿼리를 식별하는 데 사용할 수 있습니다.
|
json.query_string
| 쿼리 문자열 그 자체입니다. |
json.is_mutation
| 변경이 있을 때 true, 그렇지 않으면 false입니다.
|
json.query_analysis.used_fields
| 쿼리에서 선택된 GraphQL 필드의 목록입니다. |
json.query_analysis.used_deprecated_fields
| 쿼리에서 선택된 폐기된 GraphQL 필드의 목록입니다. |
json.query_analysis.duration_s
| 쿼리 실행의 지속 시간(초)입니다. |
json.query_analysis.complexity
| 쿼리의 복잡성 점수입니다. |
유용한 필터
각 GraphQL 쿼리의 로그와 다음 Kibana 필터를 결합하여 쿼리 로그를 더 자세히 조사하세요.
특정 필드를 사용한 쿼리
특정 필드를 사용한 쿼리로 로그를 필터링하세요:
- 필터 추가:
- 필터:
json.query_analysis.used_fields - Operator:
is - Value:
Type.myField, 여기서Type.myField는 우리의 GraphQL API 리소스 문서에 표시된 유형 이름 및 필드 이름입니다.
- 필터:
- 새로 고침(Refresh) 선택.
폐기된 필드를 사용한 쿼리
폐기된 특정 필드를 사용한 쿼리 로그를 위의 단계를 따라 수행하지만 대신 json.graphql.used_fields 필터를 사용하세요.
전체 요청의 로그
전체 요청 로그에는 요청 내의 모든 쿼리 멀티플렉싱에 대한 로그 데이터뿐만 아니라 GraphQLController#execute 외부에서 소요된 시간의 데이터도 포함됩니다.
전체 요청 로그를 보려면 각 GraphQL 쿼리의 로그에서 언급된 json.subcomponent 필터를 적용하지 마시고 대신:
- 필터 추가:
- 필터:
json.meta.caller_id - Operator:
is - Value:
GraphqlController#execute
- 필터:
- 새로 고침(Refresh) 선택.
위에서 설명한 쿼리 로그와의 차이점은 다음과 같습니다:
도움말