# 지표 카드

> 지표 카드의 참고 문서입니다. 미니 차트와 분포, 표시 구간의 통계, 보관, 그리고 편집기의 모든 속성을 다룹니다.

**지표 카드**는 숫자 포인트 하나를 크게 적고, 그 아래에 미니 차트를, 그 옆에 지금 보여 주는 구간의 통계를 덧붙일 수 있습니다. 카드는 스테이션의 실시간 계열 수집기를 거쳐 자기 샘플을 스스로 모으므로, 빈 그림이 아니라 채워진 구간으로 열립니다. 포인트에 읽은 값이 없으면 카드는 결측 표시(`—`)를 보여 주고 단위를 적지 않습니다. 선언한 구간은 값이 드는 자리에 따라 읽은 값에 색을 입히고, 어느 구간도 가리키지 않는 값은 아무 색도 가지지 않습니다. `NaN`은 결측이 아니라 읽은 값입니다. 카드는 그 낱말을 단위와 함께 적으며, `NaN`은 눈금 위에 자리가 없으므로 어느 구간도 색을 입히지 않고 차이는 결측 표시를 보여 줍니다.

## 데이터 {#data}

| 속성 | 하는 일 | 값 | 기본값 |
|---|---|---|---|
| 주소 | 보여 줄 숫자 포인트의 뿌리 있는 Logic 주소입니다. 살아 있는 포인트 목록에서 숫자 포인트만 걸러 제안하고, 이름을 부르고 나면 그 포인트의 지금 읽은 값을 보여 줍니다. | 주소 | 비어 있음 |

## 형식 {#format}

| 속성 | 하는 일 | 값 | 기본값 |
|---|---|---|---|
| 단위 | 값 옆에 적는 단위 꼬리표이며 없어도 됩니다. | 글 | 비어 있음 |
| 소수 자릿수 | 읽기 표시의 고정된 소수 자릿수입니다(큰 숫자, 통계, 차이 모두). 비워 두면 값 갈래가 정수인 포인트의 큰 숫자는 소수 없이, 그 밖의 값은 스테이션의 자릿수로 적힙니다. 보여 주는 구간의 최소와 최대는 같은 포인트의 읽은 값이므로 큰 숫자를 따르고, 기준값과 그 차이도 큰 숫자를 따릅니다(정수면 소수 없이, 실수면 스테이션의 자릿수로). 평균은 스테이션의 자릿수를 씁니다. 정수들의 평균이 정수인 일은 드물기 때문입니다. | 0에서 15 | 비우면 스테이션 설정을 씁니다 |
| 자릿수 | 큰 숫자가 소수 구분 기호 앞에 잡아 두는 자리 수입니다. 그보다 큰 값은 표시로 알리고(`####`) 전체는 도구 설명에 담습니다. 낱말로 답하는 포인트(오더, 배치, 플래그)는 모두 숫자로 되어 있더라도 결코 이 표시를 달지 않습니다. 칸에 들어가지 않는 부분은 말줄임표(…)로 끝나고, 읽은 값 전체는 도구 설명에 담깁니다. | 1에서 20 | 비우면 5자리를 잡아 둡니다 |
| 글자 크기 | 칸이 글자 크기를 정할지, 운전자가 정할지입니다. | 칸이 허락하는 만큼 크게 · 내가 정한 크기 | 칸이 허락하는 만큼 크게 |
| 포인트 | 정한 크기이며 어느 칸에서든 그대로 그려집니다. 정한 크기 방식에서만 나옵니다. | 9에서 144 | 12 |
| 읽는 형식 | 읽기 표시를 어떻게 적는지입니다. | 숫자 · 백분율 · 소요 시간 | 숫자 |
| 값이 세는 것 | 형식이 소요 시간인 동안 값 한 단위가 무엇을 뜻하는지입니다. | 초 · 밀리초 · 분 | 초 |
| 최소 보이기 | 지금 보여 주는 구간의 최소를 통계 줄에 적습니다. | 켬 / 끔 | 켬 |
| 최대 보이기 | 지금 보여 주는 구간의 최대를 적습니다. | 켬 / 끔 | 켬 |
| 평균 보이기 | 지금 보여 주는 구간의 평균을 적습니다. | 켬 / 끔 | 끔 |
| 기준값과의 차이 보이기 | 읽은 값이 선언한 기준값에서 얼마나 떨어져 있는지를 값 아래에 `Δ`로 적고, 기준값 자체는 도구 설명에 담습니다. 기준값을 선언하지 않은 동안에는 아무 말도 하지 않습니다. 아무것도 아닌 것과의 차이는 읽은 값이 아니기 때문입니다. | 켬 / 끔 | 끔 |

통계와 차이는 같은 값을 두 번째로 읽은 것이며, 카드 자신의 선언에 따라 적힙니다. 큰 숫자의 글자 크기가 무엇이든 이들은 카드의 작은 크기를 지킵니다.

통계는 대시보드가 그리는 가장 작은 글자로 적힙니다. 그래서 그 크기로 통계 줄 전체를 담기에 너무 좁은 카드라도 통계를 숫자 중간에서 자르지 않습니다. 줄은 `####` 표시 뒤로 물러나고, 모든 통계는 그 줄의 도구 설명에 담깁니다. 줄이 요구하는 폭은 화면의 읽은 값이 아니라 선언(**자릿수**와 **소수 자릿수**)에서 나옵니다.

## 미니 차트 {#mini-chart}

| 속성 | 하는 일 | 값 | 기본값 |
|---|---|---|---|
| 그리는 방식 | 카드가 읽은 값 아래에 무엇을 그리는지입니다. 어느 것을 그리든 값과 품질과 그 값이 드는 구간은 같습니다. | 구간을 지나는 선 · 샘플의 분포 · 없음 | 구간을 지나는 선 |
| 계급 | 분포가 관측된 범위를 똑같은 계급 몇 개로 자르는지입니다. 분포에서만 나옵니다. | 2에서 40 | 10 |
| 대상(샘플 수) | 분포가 가장 최근 샘플 가운데 몇 개를 세는지입니다. 표시 구간이 스파크라인을 담아 주듯 분포를 담아 줍니다. 버퍼가 가진 것보다 큰 수를 적으면 있는 만큼만 셉니다. 계급은 관측된 읽은 값의 것이지 그 밖의 무엇의 것도 아니기 때문입니다. | 2에서 20,000 | 120 |
| 강조 | 미니 차트의 색이 어디에서 오는지입니다. 뜻이 아니라 정체입니다. 분포의 계급에 대해서도 구간이 마지막 말을 가집니다. | 보통 글자 색 · 지정한 색 · 색 포인트 | 보통 글자 색 |
| 밝게 / 어둡게 | 강조색을 밝은 테마와 어두운 테마의 짝으로 적습니다. 어느 쪽이 화면에 나오는지는 돌고 있는 테마가 정하므로 둘 다 적습니다. 강조가 지정한 색일 때에만 나옵니다. | 각각 `#RRGGBB` | 둘 다 `#5470C6` |
| 색 포인트 | 강조가 따라가는 색 포인트의 뿌리 있는 Logic 주소입니다. 강조가 색 포인트일 때에만 나옵니다. | 주소 | 비어 있음 |

분포는 품질이 정상이고 유한한 샘플만 셉니다. 그래서 나쁜 품질은 선에 난 구멍으로 읽히는 것과 똑같이 세어진 샘플이 줄어든 것으로 읽힙니다. 세어진 모든 샘플이 같은 값을 읽었으면 그 전부를 담은 계급 하나가 있습니다. 카드는 무엇을 세었는지를 분포 아래에 적습니다.

## 이력 {#history}

서로 다른 두 손잡이이며 [선 차트](component-line-chart)와 같습니다. 표시 구간은 카드가 담아 보여 주는 것이고, 보관은 스테이션이 그 뒤에 쥐고 있는 것입니다. 샘플은 메모리에 있고, 애플리케이션을 다시 시작하면 수집도 처음부터 다시 합니다.

| 속성 | 하는 일 | 값 | 기본값 |
|---|---|---|---|
| 보관 | 보관하는 수가 무엇을 뜻하는지입니다. | 표시 구간만큼 · 일정한 시간만큼 · 일정한 샘플 수만큼 | 표시 구간만큼 |
| 보관 시간(s) | 보관이 일정한 시간만큼일 때 지키는 길이입니다. | 5에서 604,800(7일) | 600 |
| 보관(샘플 수) | 보관이 일정한 샘플 수만큼일 때 지키는 개수입니다. | 2에서 20,000 | 2,000 |

스테이션은 세 가지 상한 안에서 보관을 내줍니다. 포인트마다 20,000 샘플, 구성 요소마다 60,000, 그리고 스테이션 전체로 200,000입니다. 상한 때문에 다 내주지 못한 보관은 편집기만이 아니라 카드 자체에서도 말합니다. 보기 전용 클라이언트의 운전자가 아무 설명도 없이 짧아진 이력을 읽는 일이 없게 하기 위해서입니다. 스테이션 자신의 상한을 이미 다 쓴 경우 카드는 아무것도 모으지 않고 그렇게 말합니다. "스테이션이 허용하는 이력을 이미 다 쓰고 있으므로 이 계열은 아무것도 모으지 않습니다. 다른 차트의 보관 기간을 줄여 자리를 내십시오."

## 고급 {#advanced}

대부분의 카드가 건드리지 않는 두 항목을 담아 접어 둔 구역입니다.

| 속성 | 하는 일 | 값 | 기본값 |
|---|---|---|---|
| 표시 구간(s) | 스파크라인과 통계가 덮는 흐르는 구간입니다. | 5에서 86,400(1일) | 60 |
| 표본 주기(ms) | 카드 자신이 표본을 뜨는 주기입니다. | 100(로직 주기)에서 3,600,000(1시간) | 500 |

## 눈금 {#scale}

공통 **눈금** 구역은 구간과 기준값을 선언합니다.

- **구간**마다 자기 위의 구간이 끝난 자리부터 자기 경계까지 모두를 덮습니다. 색조(중립, 정보, 양호, 주의, 심각)는 큰 숫자에 색을 입히고, 말을 붙인 구간은 그 이름을 통계 줄에 적습니다. 색이 말해 줄 수 없는 단 한 가지입니다.
- **기준값**은 차이를 재는 기준입니다. 없음, 고정 값, 또는 레시피와 함께 움직이는 포인트입니다.