InfoGrab DocsInfoGrab Docs

Value Stream Analytics 데이터 조회

요약

GraphQL API를 사용하여 구성된 가치 흐름(value stream)과 가치 흐름 스테이지의 메트릭을 요청합니다. Value Stream Analytics 페이지에는 최근 2년 동안의 데이터가 표시됩니다. 먼저 보고에 사용할 가치 흐름을 결정해야 합니다.

히스토리
  • GraphQL을 통한 스테이지 메트릭 로드가 GitLab 17.0에서 도입되었습니다.

GraphQL API를 사용하여 구성된 가치 흐름(value stream)과 가치 흐름 스테이지의 메트릭을 요청합니다. 이 데이터는 Value Stream Analytics 데이터를 외부 시스템으로 내보내거나 보고서에 사용하려는 경우에 유용합니다.

다음 메트릭을 사용할 수 있습니다.

  • 스테이지에서 완료된 항목 수. 개수는 최대 10,000개로 제한됩니다.
  • 스테이지에서 완료된 항목의 중앙값 소요 시간.
  • 스테이지에서 완료된 항목의 평균 소요 시간.

Value Stream Analytics 페이지에는 최근 2년 동안의 데이터가 표시됩니다.

구성된 가치 흐름 조회#

사전 요구 사항:

  • Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

먼저 보고에 사용할 가치 흐름을 결정해야 합니다.

그룹에 구성된 가치 흐름을 요청하려면 다음을 실행합니다.

group(fullPath: "your-group-path") {
  valueStreams {
    nodes {
      id
      name
    }
  }
}

마찬가지로 프로젝트의 메트릭을 요청하려면 다음을 실행합니다.

project(fullPath: "your-project-path") {
  valueStreams {
    nodes {
      id
      name
    }
  }
}

스테이지 메트릭 조회#

가치 흐름의 스테이지 메트릭을 요청하려면 다음을 실행합니다.

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages {
        id
        name
      }
    }
  }
}

데이터를 사용하는 방식에 따라 하나의 특정 스테이지 또는 가치 흐름의 모든 스테이지에 대한 메트릭을 요청할 수 있습니다.

Note

모든 스테이지의 메트릭을 요청하면 일부 설치 환경에서는 너무 느릴 수 있습니다. 스테이지별로 메트릭을 요청하는 방식을 권장합니다.

스테이지의 메트릭 요청:

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages(id: "your-stage-id") {
        id
        name
        metrics(timeframe: { start: "2024-03-01", end: "2024-03-31" }) {
          average {
            value
            unit
          }
          median {
            value
            unit
          }
          count {
            value
            unit
          }
        }
      }
    }
  }
}
Note

항상 시간 범위를 지정하여 메트릭을 요청합니다. 지원되는 가장 긴 시간 범위는 180일입니다.

metrics 노드는 추가 필터링 옵션을 지원합니다.

  • 담당자 사용자 이름
  • 작성자 사용자 이름
  • 레이블 이름
  • 마일스톤 제목

필터를 사용한 요청 예시:

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages(id: "your-stage-id") {
        id
        name
        metrics(
          labelNames: ["backend"],
          milestoneTitle: "17.0",
          timeframe: { start: "2024-03-01", end: "2024-03-31" }
        ) {
          average {
            value
            unit
          }
          median {
            value
            unit
          }
          count {
            value
            unit
          }
        }
      }
    }
  }
}

모범 사례#

  • 현재 상태를 정확하게 파악하려면 시간 범위의 끝에 최대한 가까운 시점에 메트릭을 요청합니다.
  • 정기적인 보고를 위해 스크립트를 만들고 예약된 파이프라인 기능을 사용하여 적시에 데이터를 내보낼 수 있습니다.
  • API를 호출하면 데이터베이스의 현재 데이터를 가져옵니다. 시간이 지나면 데이터베이스의 기반 데이터가 바뀌어 같은 메트릭이 달라질 수 있습니다. 예를 들어 그룹에서 프로젝트를 이동하거나 제거하면 그룹 수준 메트릭에 영향을 줄 수 있습니다.
  • 이전 기간의 메트릭을 다시 요청하여 이전에 수집한 메트릭과 비교하면 데이터의 편차를 확인할 수 있으며, 이를 통해 변화하는 추세를 찾아내고 설명하는 데 도움이 됩니다.

Value Stream Analytics 데이터 조회

GitLab v19.6
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

GraphQL API를 사용하여 구성된 가치 흐름(value stream)과 가치 흐름 스테이지의 메트릭을 요청합니다. Value Stream Analytics 페이지에는 최근 2년 동안의 데이터가 표시됩니다. 먼저 보고에 사용할 가치 흐름을 결정해야 합니다.

히스토리
  • GraphQL을 통한 스테이지 메트릭 로드가 GitLab 17.0에서 도입되었습니다.

GraphQL API를 사용하여 구성된 가치 흐름(value stream)과 가치 흐름 스테이지의 메트릭을 요청합니다. 이 데이터는 Value Stream Analytics 데이터를 외부 시스템으로 내보내거나 보고서에 사용하려는 경우에 유용합니다.

다음 메트릭을 사용할 수 있습니다.

  • 스테이지에서 완료된 항목 수. 개수는 최대 10,000개로 제한됩니다.
  • 스테이지에서 완료된 항목의 중앙값 소요 시간.
  • 스테이지에서 완료된 항목의 평균 소요 시간.

Value Stream Analytics 페이지에는 최근 2년 동안의 데이터가 표시됩니다.

구성된 가치 흐름 조회#

사전 요구 사항:

  • Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.

먼저 보고에 사용할 가치 흐름을 결정해야 합니다.

그룹에 구성된 가치 흐름을 요청하려면 다음을 실행합니다.

group(fullPath: "your-group-path") {
  valueStreams {
    nodes {
      id
      name
    }
  }
}

마찬가지로 프로젝트의 메트릭을 요청하려면 다음을 실행합니다.

project(fullPath: "your-project-path") {
  valueStreams {
    nodes {
      id
      name
    }
  }
}

스테이지 메트릭 조회#

가치 흐름의 스테이지 메트릭을 요청하려면 다음을 실행합니다.

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages {
        id
        name
      }
    }
  }
}

데이터를 사용하는 방식에 따라 하나의 특정 스테이지 또는 가치 흐름의 모든 스테이지에 대한 메트릭을 요청할 수 있습니다.

Note

모든 스테이지의 메트릭을 요청하면 일부 설치 환경에서는 너무 느릴 수 있습니다. 스테이지별로 메트릭을 요청하는 방식을 권장합니다.

스테이지의 메트릭 요청:

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages(id: "your-stage-id") {
        id
        name
        metrics(timeframe: { start: "2024-03-01", end: "2024-03-31" }) {
          average {
            value
            unit
          }
          median {
            value
            unit
          }
          count {
            value
            unit
          }
        }
      }
    }
  }
}
Note

항상 시간 범위를 지정하여 메트릭을 요청합니다. 지원되는 가장 긴 시간 범위는 180일입니다.

metrics 노드는 추가 필터링 옵션을 지원합니다.

  • 담당자 사용자 이름
  • 작성자 사용자 이름
  • 레이블 이름
  • 마일스톤 제목

필터를 사용한 요청 예시:

group(fullPath: "your-group-path") {
  valueStreams(id: "your-value-stream-id") {
    nodes {
      stages(id: "your-stage-id") {
        id
        name
        metrics(
          labelNames: ["backend"],
          milestoneTitle: "17.0",
          timeframe: { start: "2024-03-01", end: "2024-03-31" }
        ) {
          average {
            value
            unit
          }
          median {
            value
            unit
          }
          count {
            value
            unit
          }
        }
      }
    }
  }
}

모범 사례#

  • 현재 상태를 정확하게 파악하려면 시간 범위의 끝에 최대한 가까운 시점에 메트릭을 요청합니다.
  • 정기적인 보고를 위해 스크립트를 만들고 예약된 파이프라인 기능을 사용하여 적시에 데이터를 내보낼 수 있습니다.
  • API를 호출하면 데이터베이스의 현재 데이터를 가져옵니다. 시간이 지나면 데이터베이스의 기반 데이터가 바뀌어 같은 메트릭이 달라질 수 있습니다. 예를 들어 그룹에서 프로젝트를 이동하거나 제거하면 그룹 수준 메트릭에 영향을 줄 수 있습니다.
  • 이전 기간의 메트릭을 다시 요청하여 이전에 수집한 메트릭과 비교하면 데이터의 편차를 확인할 수 있으며, 이를 통해 변화하는 추세를 찾아내고 설명하는 데 도움이 됩니다.