목록 위젯

목록 위젯 (List Widget)

목록(List) 위젯은 로그, RUM, 이벤트 같은 다양한 소스에서 오는 이벤트와 이슈 목록을 표시해요. 위젯이 강조하고 표시할 이벤트를 좁히려면 소스를 검색하고 쿼리해요.

출처: 문서

본문

개요

목록 위젯은 다양한 소스(예: 로그, RUM, 이벤트)에서 오는 이벤트와 이슈 목록을 표시해요. 소스를 검색하고 쿼리해 위젯이 강조하고 표시할 이벤트를 좁힐 수 있어요.

설정

구성

1. 그래프로 표시할 데이터 유형을 선택해요. 목록 위젯은 조직에 활성화된 제품에 따라 많은 데이터 소스를 지원해요. 전체 목록은 "지원되는 데이터 소스"를 참조해요.
2. 표시 기본 설정을 설정해요. screenboard와 노트북에서 위젯이 사용자 지정 시간 범위를 가질지 전체 시간 범위를 사용할지 선택해요.
3. (선택) 그래프에 제목을 지정해요(또는 권장 제목을 위해 비워 둬요).

지원되는 데이터 소스

소스 드롭다운에서 사용할 수 있는 데이터 소스는 조직에서 활성화된 제품에 따라 달라져요. 다음 표는 각 데이터 소스, 표시되는 데이터, 제품 요구 사항을 나열해요. 가능한 경우 표의 데이터 소스를 클릭해 구성 옵션으로 이동해요.

*(Preview)*로 표시된 데이터 소스는 Preview 상태이며 조직에서 사용하지 못할 수 있어요.

참고: Recommendations 데이터 소스는 Cloud Cost Management 권장 사항만 표시해요. APM 권장 사항은 List 위젯 데이터 소스로 사용할 수 없어요. 조직에 Cloud Cost Management가 구성되지 않은 경우 위젯은 Not Accessible 메시지를 표시해요. 이는 권한이 부족하기 때문이 아니라 데이터 소스가 Cloud Cost Management를 요구하기 때문이에요.

옵션

각 데이터 소스에는 자체 구성이 있어요. 대부분의 데이터 소스에서 다음을 할 수 있어요:

• 표시할 열을 선택해요.
• 열과 방향(오름차순 또는 내림차순)을 선택해 목록을 정렬해요. 사용 가능한 정렬 열은 위젯에 표시된 열이에요.
• 검색 쿼리로 결과를 좁혀요.

다음 데이터 소스는 추가 또는 다른 옵션이 있어요.

Cases: (오름차순/내림차순) 정렬: Alert count, Last created, Case key, Last updated, Priority, Status, Unassigned.

CI pipeline: 표시할 Level을 선택해요: Pipeline, Stage, Job, Step, Custom.

Data Observability (Preview): 엔티티 유형(데이터베이스 테이블 또는 데이터베이스 열)을 선택해요. 사용 가능한 열과 정렬 옵션은 엔티티 유형에 따라 달라져요.

Database recommendations (Preview): (오름차순/내림차순) 정렬: Severity, Type, First seen, Last seen.

Detection rules (Preview): 정렬 가능한 열에는 Name, Creation Date, Last Update Date, Enabled, Severity, Source가 있어요. 표시되는 규칙을 필터링할 규칙 제품을 선택할 수도 있어요.

Events: 보고 형식 크기: Small(제목만)(기본값), Large(전체 이벤트).

Incidents: (오름차순/내림차순) 정렬: Created, Detected, Modified, Resolved, Severity, Status, Title.

Infrastructure resources (Preview): 표시할 Resource type을 선택해요. 예: Pods, Containers, Deployments, Services, Nodes. 사용 가능한 열과 정렬 옵션은 리소스 유형에 따라 달라져요.

Issues: 정렬: Relevance(기본값), Count, Newest, Impacted sessions(RUM 이슈만). 사용 가능한 열은 이슈 소스(로그, APM, RUM)에 따라 달라져요. 참고: 정렬 선택을 변경해도 표시되는 열은 변경되지 않아요. impacted sessions로 정렬하고 위젯에서 보려면 그래프 편집기에서도 "Impacted Sessions" 열을 추가해야 해요.

Logs: 그룹화: Patterns, Transactions. 로그 구성에 따라 저장 위치를 선택할 수도 있어요: Standard Indexes, Standard Indexes + Flex Logs, Online Archives. 메시지 열에서는 표시할 줄 수(1, 3, 10)를 선택할 수 있어요.

Notebook, DDSQL Editor, Reference Tables, Developer Portal: 이 데이터 소스들은 저장된 데이터셋 또는 테이블의 행을 표시해요: - Notebook 및 DDSQL Editor: 게시된 데이터셋을 선택. - Reference Tables: 참조 테이블을 선택. - Developer Portal: 서비스, API, 데이터 저장소 같은 소프트웨어 엔티티 테이블을 선택. 이 데이터 소스들에서 다음을 할 수 있어요: - Display first를 설정해 행 수를 제한(10, 25, 50, 100, 500, 1000 또는 사용자 지정 값). - Show All Columns를 토글하거나 최대 12개 열을 선택해 표시. - 열의 정렬 아이콘을 클릭해 정렬. - 검색 쿼리로 행을 필터링.

On-Call: Team을 선택하고, 선택적으로 Tags를 추가해 표시되는 이벤트를 필터링해요.

Recommendations: Recommendations 데이터 소스의 열은 고정되어 있으며 사용자 지정할 수 없어요.

Spans and Watchdog Alerts: 이 데이터 소스들은 검색 쿼리를 지원하지만 정렬 옵션은 제공하지 않아요. Watchdog Alerts는 고정된 필드 집합을 표시해요.

Workload Protection Agent (Preview): Content 열에서 표시할 줄 수(1, 3, 10)를 선택할 수 있어요.

API

이 위젯은 **Dashboards API**와 함께 사용할 수 있어요. widget JSON 스키마 정의는 다음 표를 참조해요:

주요 필드:

요청의 주요 항목:

• columns [필수] (object[]): 위젯 열. field [필수] (string) 및 width [필수] (enum: auto,compact,full).
• query [필수] (object): 업데이트된 목록 스트림 위젯. data_source [필수] (enum) 및 query_string [필수] (string) 포함. data_source는 logs_stream, event_stream, ci_pipeline_stream, issue_stream, incidents_stream, case_stream 등을 지원하며 기본값은 logs_stream이에요.
• response_format [필수] (enum): 위젯 응답 형식. 허용되는 enum 값: event_list

JSON 예시:

{
  "description": "string",
  "legend_size": "string",
  "requests": [
    {
      "columns": [
        {
          "field": "content",
          "width": "compact"
        }
      ],
      "query": {
        "assignee_uuids": [],
        "clustering_pattern_field_path": "message",
        "compute": [
          {
            "aggregation": "count",
            "facet": "resource_name"
          }
        ],
        "data_source": "logs_stream",
        "event_size": "string",
        "group_by": [
          {
            "facet": "resource_name"
          }
        ],
        "indexes": [],
        "persona": "string",
        "query_string": "@service:app",
        "sort": {
          "column": "",
          "order": "desc"
        },
        "states": [],
        "storage": "indexes",
        "suspected_causes": [],
        "team_handles": [],
        "version": "string"
      },
      "response_format": "event_list"
    }
  ],
  "show_legend": false,
  "time": {
    "hide_incomplete_cost_data": false,
    "live_span": "5m"
  },
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "list_stream"
}

더 알아보기 (Learn more)

• Building Dashboards using JSON
• Notebooks
• Discovering Table, List, SLO, and Architecture Widgets