Varnish Cache 온-호스트 통합 은 Varnish Cache 환경에서 인벤토리 및 메트릭을 수집하여 New Relic으로 전송하여 상태를 모니터링할 수 있습니다. 인스턴스, 잠금, 메모리 풀, 스토리지 및 백엔드 수준에서 메트릭을 수집합니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
통합은 Varnish Cache 1.0 이상과 호환됩니다.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
- 인프라 에이전트를 설치합니다 .
- 인프라 에이전트와 호환되는 Linux 배포 또는 Windows 버전.
빠른 시작
Varnish Cache 환경을 신속하게 계측하고 설치 안내를 통해 원격 측정 데이터를 보내십시오. 가이드 설치는 New Relic CLI 및 인프라 에이전트를 다운로드하고 설치하는 사용자 환경에 대한 사용자 정의 CLI 명령을 생성합니다.
시작할 준비가 되셨습니까? 이 버튼 중 하나를 클릭하여 사용해 보십시오.
가이드 설치는 인프라 에이전트를 사용하여 Varnish Cache 통합을 설정합니다. 뿐만 아니라 사용자 환경에서 실행 중인 다른 애플리케이션 및 로그 소스를 검색한 다음 계측해야 할 항목을 추천합니다.
안내 설치는 대부분의 설정에서 작동합니다. 그러나 귀하의 요구 사항에 적합하지 않은 경우 아래에서 다른 방법을 찾아 Varnish Cache 환경 모니터링을 시작할 수 있습니다.
설치 및 활성화
Varnish Cache 통합을 설치하려면:
추가 참고 사항:
- Advanced: tarball 파일에서 통합을 설치하는 것도 가능합니다. 이렇게 하면 설치 및 구성 프로세스를 완전히 제어할 수 있습니다.
- On-host integrations do not automatically update. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.
이 문서가 설치하는데 도움이 되셨나요?
통합 구성
통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다.
구성 파일에는 interval
, timeout
, inventory_source
와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 보려면 구성 형식 문서를 참조하십시오.
중요
여전히 레거시 구성/정의 파일을 사용하고 있다면 이 문서 에서 도움을 받으십시오.
Varnish와 관련된 특정 설정은 구성 파일의 env
섹션을 사용하여 정의됩니다. 이러한 설정은 Varnish 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다. 유효한 설정 목록은 다음 섹션에 설명되어 있습니다.
바니시 캐시 인스턴스 설정
Varnish Cache 통합은 메트릭(M)과 인벤토리(I) 정보를 모두 수집합니다. 각 특정 컬렉션에 사용할 수 있는 설정을 알아보려면 아래의 Applies To 열을 확인하세요.
' '
환경 | 설명 | 기본값 | 적용 대상 |
---|---|---|---|
INSTANCE_NAME | 사용자는 뉴렐릭에서 이로부터 데이터를 식별하기 위해 이름을 정의했습니다. Required. | 해당 없음 | 미 |
PARAMS_CONFIG_FILE |
| 해당 없음 | 나 |
VARNISH_NAME | 맞춤 | 해당 없음 | 중 |
METRICS | 측정항목 전용 수집을 활성화하려면 |
| |
INVENTORY | 인벤토리 전용 컬렉션을 활성화하려면 |
|
varnish-config.yml
명령은 다음 인수를 허용합니다.
이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.
- 구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
{{}}
표기법을 사용하여 환경 변수의 값 바꾸기. 이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다. 여기에서 더 읽어보세요.- 비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.
라벨/맞춤 속성
환경 변수는 등의 구성 설정을 제어하는 데 사용될 수 있으며, 그런 다음 인프라 에이전트를 통해 전달됩니다. 이 기능을 사용하는 방법에 대한 지침은 인프라 에이전트 구성을 참조하세요. 라벨을 사용하여 지표를 더욱 장식할 수 있습니다. 레이블을 사용하면 지표에 핵심 가치 쌍 속성을 추가할 수 있으며, 이를 지표를 쿼리, 필터링 또는 그룹화하는 데 사용할 수 있습니다.
기본 샘플 구성 파일에는 라벨의 예가 포함되어 있지만 필수는 아니므로 원하는 라벨을 제거, 수정 또는 추가할 수 있습니다.
labels: env: production role: varnish
구성 예
varnish-config.yml
파일 구성 예:
호스트 내 통합 구성의 일반 구조에 대한 자세한 내용은 구성 을 참조하십시오.
데이터 찾기 및 사용
뉴렐릭에서 통합 데이터를 찾으려면 one.newrelic.com > All capabilities > Infrastructure > Third-party services 으로 이동하여 Varnish Cache 통합 링크 중 하나를 선택하세요.
New Relic에서 Varnish Cache 데이터는 다음 이벤트 유형에 첨부됩니다.
VarnishSample
VarnishLockSample
VarnishStorageSample
VarnishMempoolSample
VarnishBackendSample
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목 데이터
Varnish Cache 통합은 다음 메트릭 데이터 속성을 수집합니다. 각 측정항목 이름에는 bans.
또는 main.
과 같은 카테고리 표시기와 마침표가 접두사로 붙습니다.
팁
메트릭 이름에서 알 수 있듯이 많은 메트릭이 총계 대신 비율(초당)로 계산됩니다. 요율로 계산되는 측정항목에 대한 자세한 내용은 spec.csv 파일 을 참조하세요.
샘플 메트릭 바니시
이러한 속성은 VarnishSample 이벤트 유형을 쿼리하여 찾을 수 있습니다.
미터법 | 설명 |
---|---|
| 최대 연결에 도달한 횟수입니다. |
| 백업에 실패한 연결 수입니다. |
| 재활용된 백엔드 연결 수입니다. |
| 재시도된 백엔드 연결 수입니다. |
| 백엔드 연결 재사용 횟수입니다. |
| 성공적인 백엔드 연결 수, |
| '비정상' 백엔드 상태로 인해 시도되지 않은 백엔드 연결 수입니다. |
| 시작된 총 백엔드 가져오기 수입니다. |
| 이루어진 총 백엔드 연결 요청 수입니다. |
| 금지 목록에 금지 카운터가 추가되었습니다. |
| '완료'로 표시된 차단 수입니다. |
| 차단(lurker)에 대한 금지로 인해 사망한 개체의 수입니다. |
| 차단 목록에서 삭제된 차단 카운터입니다. |
| 나중에 동일한 금지로 대체된 금지의 수입니다. |
| 조각화로 인해 지속 금지 목록에 추가 바이트가 있습니다. |
| 개체 조회 중 차단으로 인해 사망한 개체 수입니다. |
| 조회하는 동안 서로에 대해 테스트된 테스트 및 개체 수입니다. |
| ban-lurker가 조회를 기다려야 했던 횟수입니다. |
| ban-lurker가 죽인 개체의 수입니다. |
| ban-lurker가 서로에 대해 테스트한 금지 및 개체 수를 계산합니다. |
| ban-lurker가 동안 서로에 대해 테스트한 테스트와 개체의 수입니다. |
|
|
| 지속 금지 목록에서 사용하는 바이트입니다. |
|
|
| 해시 조회 중에 서로에 대해 테스트된 금지 및 개체 수입니다. |
| 유예된 캐시 적중 횟수입니다. 유예 캐시 적중은 개체가 만료된 캐시 적중입니다. 이 조회수는 |
| 백엔드 서버에서 객체를 가져오지 않고 클라이언트에 객체가 전달된 횟수입니다. |
| 객체를 클라이언트에 전달하기 전에 백엔드에서 가져온 횟수입니다. |
| 누락 응답에 대해 적중 개체가 반환된 횟수입니다. |
| 통과 응답에 대해 적중 개체가 반환된 횟수입니다. |
| Edge Side Include(ESI) 구문 분석 오류(잠금 해제). |
| ESI(Edge Side Include) 구문 분석 경고(잠금 해제). |
|
|
|
|
| 콘텐츠 길이가 있는 |
| EOF가 있는 |
|
|
| 요청이 HEAD이므로 본문이 없는 |
| 본문이 없는 |
| 1XX 응답으로 인해 본문이 없는 |
| 204 응답으로 인해 본문이 없는 |
| 304 응답으로 인해 본문이 없는 |
|
|
| 중요 비트 트리 기반 해시(HCB) 삽입 수입니다. |
| 잠금이 있는 HCB 조회 수입니다. |
| 잠금이 없는 HCB 조회 수입니다. |
| 더 많은 저장 공간이 필요한 횟수이지만 한계에 도달했습니다. |
| LRU 목록에서 수행된 이동 작업의 수입니다. |
| 새 개체를 위한 공간을 만들기 위해 저장소에서 강제로 제거된 LRU(가장 최근에 사용한 개체) 개체의 수입니다. |
| 백엔드 수. |
| 금지 횟수입니다. |
| 사용 중인 objhdr에서 절전 모드 후 종료된 요청 수입니다. |
| 사용 중인 objhdr에서 절전 모드로 전송된 요청 수입니다. |
| 사용 중인 objhdr에서 절전 모드 후 깨운 요청 수입니다. |
| 만료된 개체의 수입니다. |
| 만료 스레드에 메일로 전송된 개체 수입니다. |
| 만료 스레드에서 받은 개체 수입니다. |
| gunzip 작업의 수입니다. |
| 테스트 gunzip 작업의 수입니다. |
| gzip 작업의 수입니다. |
| 만들어진 objectcore 구조체의 수입니다. |
| 생성된 반대된 구조체의 수입니다. |
| 만들어진 객체 구조체의 수입니다. |
| 통과된 총 요청이 표시됩니다. |
| 본 총 파이프 세션입니다. |
| 스레드 풀의 수입니다. |
| 제거된 개체의 수입니다. |
| 실행된 제거 작업의 수입니다. |
| 삭제된 요청 수입니다. |
| 본 총 세션 수입니다. |
| 스레드를 기다리는 세션 큐의 길이입니다. |
| 스레드당 통계가 전역 카운터에 합산된 횟수입니다. |
| 총 합성 반응이 이루어졌습니다. |
| 총 스레드 수입니다. |
| 모든 풀에서 생성된 총 스레드 수입니다. |
| 모든 풀에서 파괴된 총 스레드 수입니다. |
| 스레드 생성에 실패한 횟수입니다. |
| 더 많은 스레드가 필요했지만 스레드 풀에서 한계에 도달한 횟수입니다. |
| 부활하지 않은 개체의 수입니다. |
| 하위 프로세스 가동 시간(밀리초)입니다. |
| 사용 가능한 VCL(바니시 구성 언어) 수. |
| 폐기된 VCL의 수입니다. |
| VCL 실패 횟수입니다. |
| 총 로드된 VCL 수입니다. |
| 로드된 Varnish 모듈(VMOD)의 수입니다. |
| 신호로 인해 자식 프로세스가 종료된 횟수입니다. |
| 자식 프로세스가 코어 덤프를 생성한 횟수입니다. |
| 자식 프로세스가 완전히 중지된 횟수입니다. |
| 관리 프로세스가 아동의 패닉을 포착한 횟수입니다. |
| 자식 프로세스가 시작된 횟수입니다. |
| 자식 프로세스가 완전히 중지된 횟수입니다. |
| 관리 프로세스 가동 시간(밀리초)입니다. |
| 400개 오류에 따라 수신된 클라이언트 요청 수입니다. |
| 417 오류에 따라 수신된 클라이언트 요청 수 |
| HTTP 헤더 오버플로의 수입니다. |
| 파이프 세션의 클라이언트에서 전달된 총 바이트 수입니다. |
| 파이프 세션에서 클라이언트로 전달된 총 바이트 수입니다. |
| 파이프된 세션에 대해 수신된 총 요청 바이트입니다. |
| 전송된 총 요청 본문(바이트)입니다. |
| 전송된 총 요청 헤더(바이트)입니다. |
| 수신된 양호한 클라이언트 요청 수입니다. |
| 전송된 총 응답 본문(바이트)입니다. |
| 전송된 총 응답 헤더(바이트)입니다. |
| 오류 |
| 오류 |
| 오류 |
| 오류 |
|
|
| 마감된 총 세션 수입니다. |
| 오류로 마감된 총 세션 수입니다. |
| 스레드에 대해 삭제된 세션 수입니다. |
|
|
|
|
|
|
|
|
|
|
| 세션 수가 |
|
|
|
|
| 스레드에 대해 대기 중인 세션 수입니다. |
| 세션 미리 읽기. |
|
|
| 오류 |
|
|
|
|
|
|
| 성공적으로 수락된 세션 수입니다. |
| 작업자 스레드 부족으로 인해 자동으로 삭제된 세션 수입니다. |
| TCP 연결 수락 실패 횟수입니다. |
| SHM(공유 메모리) MTX 경합 수입니다. |
| 버퍼를 통한 SHM 주기 수입니다. |
| 오버플로로 인한 SHM 플러시 횟수입니다. |
| SHM 레코드 수. |
| SHM 쓰기 수입니다. |
|
|
|
|
| 작업 공간이 부족하여 배송에 실패했습니다. |
|
|
|
|
바니시 잠금 샘플 메트릭
이러한 속성은 VarnishLockSample
이벤트 유형을 쿼리하여 찾을 수 있습니다.
미터법 | 설명 |
---|---|
| 생성된 잠금의 수입니다. |
| 파괴된 잠금의 수입니다. |
| 잠금 작업 수입니다. |
바니시 스토리지 샘플 메트릭
이러한 속성은 VarnishStorageSample
이벤트 유형을 쿼리하여 찾을 수 있습니다.
미터법 | 설명 |
---|---|
| 스토리지가 스토리지 세그먼트를 제공하지 못한 횟수입니다. |
| 이 스토리지에서 할당한 총 바이트 수입니다. |
| 미해결 스토리지 할당 수입니다. |
| 스토리지가 스토리지 세그먼트를 제공하도록 요청받은 횟수입니다. |
| 스토리지에 남아 있는 바이트 수입니다. |
| 이 저장소에 반환된 총 바이트 수입니다. |
| 스토리지에서 할당된 바이트 수입니다. |
mempool 샘플 메트릭 바니시
이러한 속성은 VarnishMempoolSample
이벤트 유형을 쿼리하여 찾을 수 있습니다.
미터법 | 설명 |
---|---|
| 메모리 풀의 할당된 크기(바이트)입니다. |
| 메모리 풀 할당. |
| 사용 가능한 메모리 풀의 수입니다. |
| 사용 중인 메모리 풀의 수입니다. |
| 메모리 풀에서 계산합니다. |
| 수영장이 말랐습니다. |
| 수영장에서 재활용. |
| 메모리 풀의 요청 크기(바이트)입니다. |
| 수영장에 너무 많습니다. |
| 풀에서 시간이 초과되었습니다. |
| 재활용하기에는 너무 작습니다. |
백엔드 샘플 메트릭 바니시
이러한 속성은 VarnishBackendSample
이벤트 유형을 쿼리하여 찾을 수 있습니다.
미터법 | 설명 |
---|---|
| 백엔드가 사용 중이어서 가져오기가 시도되지 않았습니다. |
| 백엔드에 대한 동시 연결 수입니다. |
| 백엔드 연결 수가 실패했습니다. |
| 백엔드 연결 열기가 시도되지 않았습니다. |
| 행복한 건강 프로브. |
| 백엔드가 비정상이어서 가져오기가 시도되지 않았습니다. |
| 파이프된 세션에 대해 전송된 총 요청 바이트입니다. |
| 파이프 세션의 백엔드에서 전달된 총 바이트 수입니다. |
| 파이프 세션에서 백엔드로 전달된 총 바이트 수입니다. |
| 전송된 총 백엔드 요청 본문 바이트입니다. |
| 보낸 총 백엔드 요청 헤더 바이트입니다. |
| 보낸 백엔드 요청 수, |
| 수신된 총 백엔드 응답 본문 바이트입니다. |
| 수신된 총 백엔드 응답 헤더 바이트입니다. |
인벤토리 데이터
Varnish Cache 통합은 구성 매개변수를 캡처합니다. 활성 상태인 모든 매개변수에 대해 varnish.params
구성 파일을 구문 분석합니다.
데이터는 인벤토리 페이지의 config/varnish 소스 아래에있습니다. 인벤토리 데이터에 대한 자세한 내용은 통합 데이터에 대한 이해를 참조하십시오.
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.