대부분의 경우 AppSignal에서 제공하는 기본 애플리케이션 모니터링 지표, 그래프 및 시각화가 Ruby 앱에 적합합니다. 하지만 귀하는 측정 대상, 표시 방법, 앱에 대한 중요한 정보를 전달하는 방법을 어느 정도 제어하고 싶은 사용자일 수 있습니다.
AppSignal을 사용하면 앱 지표와 대시보드를 원하는 대로 맞춤 설정할 수 있습니다. 이 가이드에서는 다음을 포함하여 AppSignal의 사용자 정의 측정항목에 대해 모두 알아봅니다.
- 맞춤 측정항목이란 무엇인가요?
- 설정할 수 있는 다양한 유형의 맞춤 측정항목
- 그래프 시각화를 맞춤설정하는 방법
- 효과적인 알림을 설정하는 방법
그리고 더!
하지만 본격적으로 시작하기 전에 따라야 할 몇 가지 사항이 있습니다.
전제조건
- AppSignal 계정: 아직 없는 경우 30일 무료 평가판을 신청하세요.
- Ruby 애플리케이션: 이 앱은 Rails, Sinatra 또는 일반 Ruby와 같이 지원되는 모든 Ruby 프레임워크를 기반으로 할 수 있습니다. 또한 프로덕션 또는 개발 앱일 수도 있습니다. 자신의 앱을 가동하고 싶지 않다면 이 튜토리얼에서 사용할 예제 Sinatra 앱의 코드를 복제하세요.
참고:이 튜토리얼을 따라하기 위해 자신의 앱을 사용하는 경우, 이 튜토리얼에서 사용된 예시에서는 이를 가정하므로 앱이 최신 AppSignal Ruby gem을 사용하도록 구성되어 있는지 확인하세요.
맞춤 측정항목이란 무엇인가요?
앱의 오류율, 처리량, 성능을 측정하는 것 외에 자신의 앱에 특별히 맞춰진 맞춤 데이터를 측정하는 데 관심이 있을 수 있습니다. 예를 들어, 특정 기간에 앱에 가입한 방문자 수, 앱의 웹소켓 레이어 성능 등에 관심이 있을 수 있습니다.
이러한 맞춤형 사례의 경우 AppSignal 내에서 표준 측정 도구를 찾는 것이 어려울 수 있습니다. 대신 맞춤 측정항목을 사용해야 합니다. 맞춤 측정항목은 앱 실행 방식에 대한 더 깊은 맥락을 위해 기본 측정항목과 함께 정의하는 추가 측정항목입니다.
다음으로 첫 번째 맞춤 측정항목을 설정하는 방법을 알아보겠습니다.
맞춤 측정항목 설정
애플리케이션 내의 거의 모든 사용 사례에 대해 사용자 정의 측정항목을 설정할 수 있습니다. 모든 것이 어떻게 조화를 이루는지 이해하는 데 도움이 되는 간단한 예부터 시작해 보겠습니다.
첫 번째 단계는 AppSignal에서 추적할 사용자 정의 지표를 정의하는 것입니다. 사용 가능한 다양한 측정항목 유형을 사용하여 맞춤 측정항목을 정의할 수 있습니다.
- 게이지
- 카운터
- 배포
게이지 맞춤 측정항목
AppSignal에서는 게이지 맞춤 측정항목은 시간이 지남에 따라 증가하고 감소하는 측정항목을 측정하는 데 유용합니다.
예시 Sinatra 앱의 총 게시물 수를 측정하기 위해 간단한 게이지 사용자 정의 측정항목을 설정해 보겠습니다.
위에 표시된 코드에서는 Appsignal::Helpers::Metrics를 사용합니다. 모듈을 선택하고 set_gauge을 호출하세요. 세 가지 인수를 허용하는 메소드:
key:맞춤 측정항목의 이름입니다. 예에서는 all_posts입니다. .value- 측정할 측정항목 또는 "사물"입니다. 위에 표시된 예에서 이는 단순히 총 게시물 수입니다.tags- 사용자 정의 지표에 추가할 수 있고 측정 중인 데이터에 원하는 대로 레이블을 지정하는 데 유용한 추가 및 선택적 메타데이터입니다. 예를 들어posts_count에 쉽게 태그를 지정할 수 있습니다. 아래와 같이 환경을 설명하는 측정항목:
좋습니다. 첫 번째 사용자 정의 게이지 측정항목을 추가했습니다! 그러나 AppSignal로 돌아가면 새로운 사용자 정의 지표가 표시되지 않습니다. 대신 아래와 같이 기본 대시보드가 표시될 가능성이 높습니다.
그렇다면 맞춤 측정항목을 표시하려면 어떻게 해야 할까요? 대시보드를 추가해야 합니다. 새 대시보드를 만드는 것부터 시작하세요:
그런 다음 설명적인 제목과 설명을 사용하여 새 대시보드의 이름을 지정하세요.
맞춤 대시보드가 추가되었으면 이제 맞춤 측정항목에 대한 그래프를 추가해야 합니다.
그런 다음 새 그래프를 정의합니다.
다음은 새 그래프를 설정하는 필드에 대한 세부정보입니다.
- 아. 제목 - 새 그래프를 설명하는 제목을 입력하세요.
- ㄴ. 설명 - 선택사항이지만 새 그래프에 대한 설명을 입력할 수 있습니다.
- ㄷ. 측정항목 - 여기에서 새 그래프로 측정하고 표시할 측정항목을 정의합니다. 이는 맞춤 측정항목의 이름이거나
set_gauge에 정의된 첫 번째 인수입니다. 방법:all_posts. 이 섹션에서는 태그(예:environment 태그)를 정의할 수도 있습니다. 표시된 대로 포함됩니다.) - 디. 그래프 표시 - 새 그래프의 그래프 표시 유형을 선택하는 곳입니다.
- 마. 범례 라벨 - 여기에서 차트 범례 라벨을 맞춤설정할 수 있습니다.
- f. 데이터 형식 - 그래프 표시에 사용되는 데이터 유형을 정의합니다. 숫자, 백분율, 처리량(요청/분 또는 시간), 기간(밀리초) 또는 파일 크기(바이트)를 포함한 다양한 형식 중에서 선택할 수 있습니다.
새 그래프의 속성을 올바르게 정의한 후에는 사용자 정의 측정항목에 대한 그래프를 가져와야 합니다. 이는 아래에 표시된 것과 유사합니다:
다음으로 다음 맞춤 측정항목 유형인 카운터를 살펴보겠습니다.
카운터 맞춤 측정항목
카운터 맞춤 측정항목은 이벤트가 발생한 횟수를 측정하는 데 유용합니다. 예제 애플리케이션을 사용하여 홈(루트) 페이지를 방문할 때마다 측정하는 카운터 측정항목을 적용할 수 있습니다.
우선, 아래 표시된 코드를 포함하도록 루트 메소드를 편집하십시오:
여기서는 AppSignal의 increment_counter를 사용합니다. 메서드를 사용하여 visits_count를 전달하세요. 첫 번째 주장으로. 증분 단계는 두 번째 인수로 전달되는 정수 1입니다. tags를 추가할 수도 있습니다. hash를 세 번째 인수로 사용하지만 그대로 두겠습니다(이전 섹션에서 다루었으므로).
이제 게이지 측정항목 유형에 대해 설명된 단계를 따르세요. 표시된 것과 유사한 그래프를 제공하려면 이 카운터 측정항목에 대한 사용자 정의 그래프를 추가하세요.
분포 맞춤 측정항목으로 전환해 보겠습니다.
배포 맞춤 측정항목
AppSignal 분포 사용자 정의 지표는 단위 시간당 항목을 측정하는 데 유용합니다. 예를 들어 PDF 보고서를 생성하는 데 걸리는 시간 또는 백그라운드 작업을 실행하는 데 걸리는 시간 등이 있습니다.
예제 애플리케이션을 사용하여 개방형 API 엔드포인트에 대한 호출을 포함하도록 기본 파일을 수정해 보겠습니다. 그런 다음 사용자 정의 분포를 사용하여 API 호출에 걸리는 시간을 밀리초 단위로 측정합니다.
이제 AppSignal로 돌아가면 사용자 정의 분포를 그래프로 볼 수 있습니다.
팁:게이지 섹션에 설명된 단계에 따라 맞춤 그래프 시각화를 설정할 수 있습니다.
이제 사용자 정의 지표 및 그에 따른 그래프 시각화를 생성하는 방법을 배웠으므로 AppSignal 대시보드로 계속 돌아가서 앱에서 무슨 일이 일어나고 있는지 확인하는 것이 그리 편리하지 않다는 것을 알게 되었을 것입니다. 대신, 맞춤 측정항목에 대한 알림을 받을 수 있다면 매우 편리할 것입니다. 그렇죠?
다음에는 맞춤 측정항목에 대한 알림을 설정하는 방법을 알아보겠습니다.
알림 알림
기본적으로 오류나 성능 이벤트가 발생할 때마다 AppSignal은 해당 이벤트에 대한 인시던트를 열고 관련 섹션에 배치합니다. 예를 들어 오류인 경우 오류 목록에서 찾을 수 있고, 성능 문제는 성능 목록에 표시됩니다.
또한 AppSignal은 이메일(기본 알림 채널)을 통해 사고 알림을 보냅니다. 다음과 같은 다른 알림 채널을 설정할 수도 있습니다.
- 불화
- Google 행아웃
- 인터콤
- 마이크로소프트 팀즈
- 슬랙
- 웹훅
그리고 더 많은 것.
하지만 사용자 정의 지표 중 하나에 대한 알림 트리거를 설정하기 전에 사용 가능한 다양한 알림 옵션을 알고 있는 것이 중요합니다.
우선, 다음에 대한 알림을 설정할 수 있습니다:
- 매번 - 여기에서는 사건이 발생할 때마다 알림이 전송됩니다.
- 첫 번째 배포 - 배포 후 처음으로 사건이 발생할 때 알림이 전송된다는 의미입니다.
- 종료 후 첫 번째 - 여기에서는 이전 사건이 종료된 후 사건이 다시 발생할 때마다 알림이 전송됩니다.
- 알리지 않음 - 이름에서 알 수 있듯이 이 경우 알림은 전송되지 않지만 오류나 성능 문제는 AppSignal에서 계속 추적됩니다.
- n시간마다 또는 매일 - 이 옵션을 사용하면 한 시간 또는 하루 내에 알림을 보낼 횟수를 지정할 수 있습니다. 이 옵션은 중요한 이벤트에 대한 알림을 받는 것과 너무 많은 알림을 받는 것(귀하 또는 팀에 쉽게 부담을 줄 수 있음) 사이의 균형을 유지하는 데 적합합니다.
이러한 옵션에 대한 자세한 정보를 얻으려면 AppSignal의 알림 설정 문서를 자세히 살펴보는 것이 좋습니다.
이전에 만든 사용자 정의 측정항목 중 하나에 대한 알림을 설정하는 방법을 살펴보겠습니다. 이는 사소한 예이기는 하지만 자신의 사용 사례에 따라 수행해야 하는 단계를 보여줍니다.
맞춤 측정항목에 대한 알림 알림 설정
이 예에서는 이 게시물의 앞부분에서 API 호출 기간을 측정한 분포 측정항목을 사용합니다. 평균 지속 시간이 특정 숫자(밀리초 단위)를 초과할 때마다 이메일 알림을 받고 싶다고 가정해 보겠습니다.
이를 설정하는 단계는 다음과 같습니다:
먼저 트리거를 누르는 것부터 시작하세요. 링크를 클릭하세요.
트리거에 관련 이름을 지정한 다음 이 알림을 받을 측정을 선택하세요. 이 예에서는 fetch_books_duration을 사용하고 있습니다. 분포 맞춤 측정항목. 원하는 경우 태그를 추가할 수도 있습니다.
다음으로 비교 연산자와 확인할 값을 정의합니다. 예를 들어, 지속 시간이 1600밀리초를 초과할 때마다 경고를 받고 싶다고 가정해 보겠습니다. 이를 위해 비교 연산자 more than을 선택합니다. , 값은 1600입니다.
마지막으로 경고 준비 및 냉각 설정을 정의해야 합니다. 경고에 대한 설명, 경고 메시지에 포함될 대시보드 링크(필요한 경우), 마지막으로 알림 방법(기본값은 이메일)을 제공합니다.
그러면 여기에 입력한 설정과 일치하는 사건이 발생할 때마다 알림을 받게 됩니다.
그게 전부입니다!
마무리
이 기사에서는 AppSignal에서 일치하는 대시보드 및 그래프 시각화를 사용하여 Ruby 애플리케이션에 대한 사용자 정의 지표를 설정하는 방법을 배웠습니다.
AppSignal이 제공하는 사용자 정의 지표 기능은 매우 강력한 애플리케이션에 맞게 미세 조정할 수 있습니다. 더 많은 가능성을 발견하려면 AppSignal의 사용자 정의 지표 문서를 자세히 살펴보세요.
다음 시간까지 즐거운 코딩 되세요!
추신 Ruby Magic 게시물이 보도되는 즉시 읽으려면 Ruby Magic 뉴스레터를 구독하고 단 하나의 게시물도 놓치지 마세요!