대시보드

기본 제공 대시보드

모든 프로젝트에는 플랫폼이 정의한 읽기 전용 대시보드가 있습니다. Overview, APM, Database, Infrastructure, Errors, Crons, 그리고 Durable Object 클래스마다 하나씩입니다.

직접 만든 대시보드

Observability → Dashboards에서 대시보드를 만듭니다. 각 패널은 쿼리, 메트릭, 또는 프로젝트의 다른 무언가에 대한 참조입니다.

메트릭 패널은 overview, memory, infra, custom(이름으로 고른 사용자 정의 메트릭과 태그, 그룹 키)을 읽습니다. 모든 시계열에는 배포 표시가 붙습니다.

템플릿 변수는 모든 패널을 한 번에 좁힙니다. 변수는 태그 키(env, version, route, region 또는 직접 만든 키)를 가리키며, 패널은 필터 값에 "$name"을 써서 변수를 사용합니다. 대시보드의 기간이 패널 쿼리의 기간보다 우선합니다.

대시보드 하나에는 패널 50개와 변수 10개까지 넣을 수 있습니다. Free는 프로젝트당 사용자 정의 대시보드 3개, Pro는 무제한입니다.

코드로 관리하는 대시보드

.runlot/dashboards/의 모든 .json 파일은 배포가 실제로 적용될 때 함께 반영됩니다.

{
  "key": "checkout",
  "title": "Checkout",
  "variables": [{ "name": "version", "key": "version", "default": "*" }],
  "widgets": [
    {
      "type": "timeseries",
      "title": "Checkout p99",
      "query": {
        "view": "calculations",
        "filters": [
          { "key": "$route", "op": "eq", "value": "/checkout" },
          { "key": "$deployment.version", "op": "eq", "value": "$version" }
        ],
        "calculations": [{ "op": "p99", "key": "$wall_ms" }]
      }
    },
    {
      "type": "top_list",
      "title": "Failure reasons",
      "metric": { "metric": "custom", "params": { "name": "log.checkout.failed", "groupBy": ["reason"] } }
    },
    { "type": "service_map" }
  ]
}

• key는 대시보드의 고정 이름입니다. 소문자, 숫자, -, _로 이루어지며 builtin으로 시작할 수 없습니다. 이후 배포는 같은 키의 대시보드를 갱신하고, 파일이 사라진 저장소 대시보드는 제거합니다.
• 파일 하나는 최대 128 KiB이고, 배포 하나에 대시보드는 최대 50개입니다. 형식이 잘못된 파일은 조용히 빠지지 않고 배포를 실패시킵니다.
• 저장소 대시보드는 대시보드 UI에서 읽기 전용입니다. 기본 제공 대시보드를 포함한 모든 대시보드의 Export는 커밋할 파일을 내보냅니다.

공유

모든 대시보드에는 조직의 모든 멤버가 열 수 있는 URL이 있습니다.

읽기 전용 공개 링크에는 스위치 두 개가 필요합니다. 먼저 관리자가 프로젝트의 public dashboard links를 켭니다. 기본값은 꺼짐이며, 꺼져 있는 동안 프로젝트의 모든 공개 링크는 404로 응답합니다. 그다음 대시보드에서 Share를 눌러 링크를 만듭니다. 토큰은 한 번만 보여 주고 해시로 저장합니다. 새 토큰을 만들면 이전 토큰을 대체하며, 토큰을 폐기할 수도 있습니다. 공개 링크는 차트와 수치만 제공하며, 로그 스트림, 이슈 목록, 이벤트 테이블은 절대 제공하지 않습니다.