다음을 통해 공유


az iot ops broker

참고 항목

이 참조는 Azure CLI(버전 2.53.0 이상)에 대한 azure-iot-ops 확장의 일부입니다. az iot ops broker 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Mqtt broker 관리 및 작업.

명령

Name Description 형식 상태
az iot ops broker authn

Broker 인증 관리.

내선 번호 프리뷰
az iot ops broker authn list

인스턴스와 연결된 mqtt broker 인증 리소스를 나열합니다.

내선 번호 프리뷰
az iot ops broker authn show

mqtt broker 인증 리소스의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker authz

Broker 권한 부여 관리.

내선 번호 프리뷰
az iot ops broker authz list

인스턴스와 연결된 mqtt broker 권한 부여 리소스를 나열합니다.

내선 번호 프리뷰
az iot ops broker authz show

mqtt broker 권한 부여 리소스의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker list

인스턴스와 연결된 mqtt broker를 나열합니다.

내선 번호 프리뷰
az iot ops broker listener

Broker 수신기 관리.

내선 번호 프리뷰
az iot ops broker listener list

broker와 연결된 mqtt broker 수신기를 나열합니다.

내선 번호 프리뷰
az iot ops broker listener show

mqtt broker 수신기의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker show

mqtt broker의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker stats

dmqtt 실행 통계를 표시합니다.

내선 번호 프리뷰

az iot ops broker list

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

인스턴스와 연결된 mqtt broker를 나열합니다.

az iot ops broker list --instance
                       --resource-group

예제

'mycluster-ops-instance' 인스턴스의 모든 broker를 열거합니다.

az iot ops broker list --in mycluster-ops-instance -g myresourcegroup

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops broker show

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

mqtt broker의 세부 정보를 표시합니다.

az iot ops broker show --instance
                       --name
                       --resource-group

예제

'mycluster-ops-instance' 인스턴스에 기본 broker 'broker'의 세부 정보를 표시합니다.

az iot ops broker show -n broker --in mycluster-ops-instance -g myresourcegroup

필수 매개 변수

--instance -i

IoT Operations 인스턴스 이름입니다.

--name -n

Mqtt broker 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops broker stats

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

dmqtt 실행 통계를 표시합니다.

{지원되는 서비스 API}

  • mqttbroker.iotoperations.azure.com/v1beta1.
az iot ops broker stats [--context]
                        [--metrics-port]
                        [--namespace]
                        [--protobuf-port]
                        [--raw {false, true}]
                        [--refresh]
                        [--trace-dir]
                        [--trace-ids]
                        [--watch {false, true}]

예제

진단 Prometheus 메트릭 엔드포인트에서 주요 성능 지표를 가져옵니다.

az iot ops broker stats

주기적으로 새로 고치는 동적 디스플레이를 제외하고 이전 예제와 동일합니다.

az iot ops broker stats --watch

최소 처리를 사용하여 메트릭 엔드포인트의 원시 출력을 반환합니다.

az iot ops broker stats --raw

진단 Protobuf 엔드포인트에서 사용 가능한 모든 mq 추적을 가져옵니다. 이렇게 하면 'otel'과 Grafana 'tempo' 파일 형식이 모두 포함된 '.zip'이 생성됩니다. 마지막으로 수정된 추적 파일 특성은 추적 타임스탬프와 일치합니다.

az iot ops broker stats --trace-dir .

공백으로 구분된 16진수 형식으로 제공된 추적 ID로 추적을 가져옵니다. 'Otel' 형식만 표시됩니다.

az iot ops broker stats --trace-ids 4e84000155a98627cdac7de46f53055d

선택적 매개 변수

--context

k8s 클러스터 통신에 사용할 Kubeconfig 컨텍스트 이름입니다. 컨텍스트가 제공되지 않으면 current_context 사용됩니다.

--metrics-port

진단 서비스 메트릭 API 포트.

Default value: 9600
--namespace -n

명령이 작동해야 하는 K8s 클러스터 네임스페이스입니다. 네임스페이스가 제공되지 않으면 kubeconfig current_context 네임스페이스가 사용됩니다. 정의되지 않은 경우 대체 값 azure-iot-operations 이 사용됩니다.

--protobuf-port

진단 서비스 protobuf API 포트.

Default value: 9800
--raw

메트릭 API에서 원시 출력을 반환합니다.

허용되는 값: false, true
--refresh

통계 새로 고침 사이의 시간(초)입니다. --watch에 적용됩니다.

Default value: 10
--trace-dir

추적이 번들로 묶이고 저장되는 로컬 디렉터리입니다.

--trace-ids

공백으로 구분된 추적 ID(16진수 형식)입니다.

--watch

작업은 통계 테이블을 차단하고 동적으로 업데이트합니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.