중요
2024년 8월 26일부터 공개 또는 위치 위치에서 구형 런타임을 사용하여 새 모니터를 더 이상 생성할 수 없습니다.
2024년 10월 22일을 기점으로 컨테이너화된 미니언(분당 호출 수) 및 구형 신세틱스 손잡이 버전 의 수명이 종료 됩니다. 표시 위치의 경우 런타임 업그레이드 UI 사용하여 모니터를 최신 런타임으로 업데이트하세요. 위치 위치의 경우 모니터 성능 저하를 방지하기 위해 권장되는 마이그레이션 단계를 검토하십시오.
합성 모니터링의 API 테스트 를 사용하여 API 엔드포인트를 모니터링하여 올바르게 작동하는지 확인하십시오. New Relic은 내부적으로 http-request 모듈을 사용하여 엔드포인트에 HTTP를 호출하고 결과를 검증합니다.
[Node 16.10 이상의 API 런타임 예시]( 최신 신세틱스 전력을 사용하여 모니터를 생성하려면 Node 16.10 런타임 작성에 대한 자세한 내용을 참조하세요.
여기에 $http
객체를 사용하여 요청을 제출하는 방법을 보여주는 몇 가지 예시 함수가 있습니다. 이 객체에 사용할 수 있는 옵션에 대한 자세한 문서는 http-request readme 를 참조하십시오. (요청은 더 이상 사용되지 않지만 이러한 옵션은 계속 적용됩니다.)
팁
다른 API 테스트 예제를 보고 공유하려면 지원 포럼 합성 스크립트 섹션 또는 합성 모니터링 빠른 시작 라이브러리를방문하십시오.
API http-요청 모듈 사용
API 테스트는 $http
객체를 통해 사용할 수 있는 http-request 모듈에 의해 구동됩니다. 각 빈도 간격마다 New Relic은 선택한 각 위치에서 엔드포인트를 쿼리합니다. 모니터 생성에 대한 지침은 모니터 추가 를 참조하십시오.
요청에 대한 메타데이터를 정의 하는 방법 , GET 요청 을 만드는 방법, POST 요청 을 만드는 방법 및 결과를 확인하는 방법을 배우려면 계속 읽으십시오.
중요
최대 실행 시간 3분 후 New Relic은 스크립트를 수동으로 중지합니다.
one.newrelic.com > Synthetic monitoring > Create monitor: 펼쳐보기 편집기는 펼쳐보기 명령을 단순화하기 위한 기능, 선택기 및 기타 요소를 제안합니다(GitHub에서 사용 가능).
요청 옵션 구성
스크립트를 시작하려면:
- 요청 옵션 객체 를 저장할 변수(예:
options
)를 선언합니다. - URL 끝점 및 사용자 지정 헤더와 같은 요청 옵션을 정의합니다.
- SSL 또는 에이전트 옵션을 설정하는 경우 SSL 및 agentOptions 요구 사항 을 참조하십시오. 헤더에 일반 텍스트 자격 증명이 노출되지 않도록 SSL을 사용하는 것이 좋습니다.
팁
지원되는 요청 옵션의 전체 목록은 GitHub의 http-request
문서에서 요청(옵션, 콜백) 을 참조하세요.
다음은 options 객체에 있는 선택적 메타데이터의 예입니다.
For SSL and agentOptions: SSL 옵션을 설정하거나 agentOptions
객체를 제공하는 경우 HTTP 요청이 계측된 글로벌 에이전트를 사용하도록 하려면 요청 options
객체의 agent
속성을 $globalAgents.https
또는 $globalAgents.http
로 설정해야 합니다.
다음은 SSL 옵션 또는 agentOptions
을 사용하는 예입니다.
GET 요청 보내기
GET 요청을 하려면 $http.get
메소드를 사용하여 요청을 제출하십시오. 요청 옵션 을 정의하고 $http.get
을 사용하여 요청한 다음 응답을 검증 하여 엔드포인트가 올바른 결과를 반환하는지 확인하십시오.
POST 요청 보내기
POST 요청을 하려면 $http.post
메소드를 사용하여 요청을 제출하십시오. 요청 옵션 을 정의하고 $http.post
을 사용하여 요청한 다음 응답을 검증 하여 엔드포인트가 올바른 결과를 반환하는지 확인하십시오.
결과 검증
결과를 확인하려면 assert
모듈을 가져와 테스트 사례를 정의하세요. assert
메서드를 호출하여 엔드포인트의 응답을 확인합니다. assert
기능이 실패하면 전체 모니터가 실패한 검사로 간주됩니다. 이는 경고 알림 을 트리거하고 측정항목에 영향을 줄 수 있습니다.
중요
종합 모니터링은 예외가 발생하는 것을 허용하지 않습니다. 예외가 발생하면 스크립트가 실패합니다. assert
모듈을 사용하여 결과를 확인하고 console.log()
을 사용 하여 합성 콘솔에 결과를 기록합니다 .