플릿의 가능성에 대한 프로그래밍 방식 액세스: API 및 CLI

플릿 컨트롤은 API 및 명령줄 인터페이스를 통해 포괄적인 프로그래밍 방식 액세스를 제공하여 UI 에 의존하지 않고도 차량 운영을 자동화하고 기존 도구와 통합하고 측정, 계측을 대규모로 관리할 수 있도록 합니다.

프로그램 액세스 옵션

Fleet Control 프로그램 접근을 위한 세 가지 방법을 제공합니다.

• NerdGraph API: 차량 관리 운영(차량 생성, 구성원 관리, 구현 제어 등)을 위해 배포
• Blob Storage API: 설정 생성, 버전 관리 및 검색을 포함한 에이전트 설정 작업
• Fleet Control CLI: 대화형 명령줄 관리 및 자동화 스크립트용

API와 CLI는 언제 사용해야 할까요?

어떤 접근 방식이 사용 사례에 가장 적합한지 이해하면 Fleet Control 더욱 효율적으로 사용할 수 있습니다.

API(NerdGraph + Blob Storage API)

API는 다음과 같은 경우에 가장 적합합니다.

• 자동화 및 통합: Fleet Control 작업을 CI/CD 파이프라인, 사용자 지정 도구 또는 기타 자동화된 통합에 구축
• 코드로 포함: 교체 정의와 함께 Fleet 설정 관리
• 시스템 간 통합: Fleet Control (를) 다른 플랫폼, 지원 케이스 시스템 또는 오케스트레이션 도구와 연결
• 복잡한 워크플로우: 여러 작업을 결합하거나 외부 데이터 소스와 통합하는 정교한 자동화 시스템 구축
• 프로그래밍 방식 액세스: 자체 애플리케이션 또는 서비스에 Fleet Control 기능을 구축해야 할 때

Fleet Control CLI

CLI는 다음과 같은 경우에 가장 적합합니다.

• 대화형 작업: 명령줄에서 사람이 직접 수행하는 빠르고 간편한 작업
• 임시 관리: 일회성 관리 작업 또는 문제 해결, 해결
• 터미널 기반 작업우: 터미널에서 직접 작업하는 것을 선호하는 경우
• 로컬 테스트: 자동화 전에 차량 운행을 시험해 보기
• 셸 스크립트: 간단한 순차적 작업에 적합합니다(복잡한 자동화에는 API가 더 나을 수 있습니다).
• 학습 및 탐색: CLI는 즉각적이고 체계적인 피드백을 제공하여 제어 작업 과정을 이해하는 데 도움을 줍니다.

CLI는 동일한 API를 기반으로 구축되었으므로 기능적으로 동일한 기능을 제공합니다. 선택은 인터페이스 선호도와 사용 사례에 따라 달라집니다. CLI는 사람의 조작과 편의성을 위해, API는 프로그래밍 방식의 통합 및 자동화를 위해 사용됩니다.

NerdGraph API (플릿 운영)

NerdGraph 플릿, 멤버 및 구현, 배포를 관리하기 위한 플릿 취소 작업에 대한 액세스를 제공하는 New Relic's GraphQL API 입니다. Blob Storage API 사용하는 에이전트 설정과 달리 모든 함대 수준 작업은 NerdGraph를 사용합니다.

이것으로 할 수 있는 일 NerdGraph API

NerdGraph API 은 다음과 같은 돌연변이를 제공합니다:

• 함대 관리: 함대 생성, 업데이트 및 삭제
• 함대 구성원 관리: 함대 링에서 관리 대상 엔티티를 추가 및 제거합니다.
• 구현, 배포 관리: 구현, 업데이트, 삭제 및 트리거 구현, 배포

매개변수, 변수 설명, 요청/응답 예시 및 자세한 변형 명세를 포함한 포괄적인 문서는 NerdGraph Fleet Control 튜토리얼을 참조하세요.

API를 대화형으로 탐색하려면 NerdGraph Explorer (또는 EU 지역)을 사용하세요.

일반적인 NerdGraph 정보는 NerdGraph 소개를 참조하세요.

Blob Storage API (에이전트 설정)

Blob Storage API 은 파일 업로드 및 관리를 위해 설계된 New Relic 서비스입니다. NerdGraph 효율적인 파일 전송보다는 구조화된 데이터 쿼리에 최적화되어 있으므로 Fleet Control Blob Storage API 를 사용하여 에이전트 설정을 관리합니다. 이 API 설정 생성, 버전 관리, 콘텐츠 검색 및 삭제를 포함한 모든 설정 관련 작업을 처리합니다.

Blob Storage API로 할 수 있는 일

Blob Storage API는 다음을 지원합니다.

• 에이전트 설정 생성: 메타데이터(이름, 에이전트 유형, 관리형 유형)로 새 설정을 초기화합니다.
• 버전 관리: 기존 설정의 새 버전을 생성합니다.
• 설정 검색: 버전별 또는 최신별 설정 콘텐츠 가져오기
• 삭제 작업: 설정 또는 특정 버전을 제거합니다.
• 버전 목록: 타임스탬프를 사용하여 설정의 모든 버전을 봅니다.

curl 예제, 요청/응답 형식, 헤더 사양 및 지원되는 API 유형을 포함한 포괄적인 문서는 Blob Storage API 참조 - curl 예제 및 매개변수, 변수 세부 정보가 포함된 전체 가이드를 참조하십시오.

API 참조에는 모든 작업에 대한 작업 예제, 인증 요구 사항, 에이전트 설정을 프로그래밍 방식으로 관리하기 위한 모범 사례가 포함되어 있습니다.

Fleet Control CLI

Fleet Control CLI 은 Fleet, 설정, 구현, 배포, 멤버 및 분리 쿼리를 포함하여 모든 Fleet Control 부분을 관리하기 위한 포괄적인 명령줄 인터페이스입니다. CLI는 대화형 작업과 자동화를 위한 구조화된 터미널 기반 인터페이스를 제공합니다.

명령 계층 구조

Fleet Control 명령어는 직관적인 탐색을 위해 리소스 유형별로 정리되어 있습니다.

newrelic fleetcontrol
├── fleet                    # Fleet management
│   ├── create              # Create a new fleet
│   ├── get                 # Get fleet details
│   ├── search              # Search fleets
│   ├── update              # Update fleet
│   ├── delete              # Delete fleet(s)
│   └── members             # Manage fleet members
│       ├── add             # Add entities to ring
│       ├── remove          # Remove entities from ring
│       └── list            # List fleet members
│
├── configuration            # Configuration management
│   ├── create              # Create configuration
│   ├── get                 # Get configuration content
│   ├── delete              # Delete configuration
│   └── versions            # Manage configuration versions
│       ├── list            # List all versions
│       ├── add             # Add new version
│       └── delete          # Delete specific version
│
├── deployment               # Deployment management
│   ├── create              # Create deployment
│   ├── update              # Update deployment
│   ├── deploy              # Trigger deployment
│   └── delete              # Delete deployment
│
└── entities                 # Entity queries
    ├── get-managed         # List managed entities
    └── get-unassigned      # List available entities

핵심 역량

Fleet Control CLI 을 사용하면 다음을 수행할 수 있습니다.

• 에이전트 작업 중앙 집중화: 메가줄에서 모든 에이전트 및 통합을 설치, 모니터링, 구성 및 업데이트합니다.
• 함대 관리: 전체 함대에 대한 분량 측정, 소모 요구 사항 및 에이전트 버전 업그레이드를 기준으로 그룹화
• 생성 및 버전 설정: 작성자 저항 설정 및 여러 버전 관리
• 제어 구현, 배포: 생성, 업데이트 및 트리거 구현, 링 기반 롤아웃을 통한 배포
• 엔티티 쿼리: 관리되는 엔티티와 할당되지 않은 엔티티 목록을 확인하여 전체 자산 현황을 파악합니다.

전제 조건

Fleet Control CLI 명령어를 사용하기 전에 다음이 필요합니다.

필수 환경 변수:

$
# Your New Relic User API Key
$
export NEW_RELIC_API_KEY="NRAK-YOUR-API-KEY-HERE"
$

$
# Your New Relic Account ID
$
export NEW_RELIC_ACCOUNT_ID="your-account-id"
$

$
# Optional: Specify region (defaults to US)
$
export NEW_RELIC_REGION="US"  # or "EU" for European accounts

자격 증명 받기:

1. API 키: one.newrelic.com → 사용자 이름 클릭 → API Keys → Create a "User" key에서 사용자 API 키를 생성하세요.
2. 계정 ID: 계정 ID는 뉴렐릭 URL의 /accounts/ 뒤 또는 계정 설정에서 찾을 수 있습니다.
3. 조직 ID: 대부분의 명령은 선택적으로 --organization-id 플래그를 허용합니다. 조직 ID가 제공되지 않으면 CLI는 API 자격 증명을 사용하여 자동으로 조직 ID를 가져옵니다.

CLI 문서 전체 보기

설치 및 설정을 포함하여 Fleet Control CLI 을(를) 시작하려면 플릿의 위험 CLI 위치를 참조하세요.

자세한 Fleet Control 명령 참조, 응답 형식, 유효성 검사 규칙, 문제 해결, 해결 지침은 플릿시티 CLI README 참조하세요.

CLI 설명서에는 다음 내용이 포함됩니다.

• 모든 작업에 대한 전체 명령 참조
• 응답 형식 사양
• JSON 응답을 사용하여 작업하기 jq
• 실제적인 워크플로우 예시
• 유효성 검사 규칙 및 허용 값
• 문제 해결, 일반적인 문제 해결
• 플래그 구문 및 사용 패턴

프로그래밍 방식 액세스 시작하기

Fleet Control 프로그래밍 방식으로 사용하려면 다음을 수행하십시오.

1. 뉴렐릭 계정 설정에서 Generate a User API Key [사용자 API 키를 생성하세요]

2. 뉴렐릭 플랫폼에서 계정 ID와 조직 ID를 확인하세요.

3. 접속 방법을 선택하세요:

   • NerdGraph Explorer 을 사용하여 함대 운영을 대화형으로 탐색해 보세요.
   • 설정 관리를 위한 Blob Storage API 작업을 검토하세요.
   • 터미널 기반 설치를 위해 Fleet Control CLI 을 설치하고 구성하십시오.

4. 데이터 구조에 익숙해지기 위해 읽기 작업부터 시작하세요 (플릿 검색, 목록 보기, 설정 가져오기).

5. 프레임워크 또는 스토리 흐름으로 작업을 점진적으로 결합하여

API 사용에 대한 추가 도움말은 NerdGraph 소개 문서와 API 키 문서를 참조하세요.