alibabacloud-liverecord-diagnosis

Name: alibabacloud-liverecord-diagnosis
Author: aliyun

github.com/aliyunクラウド・DevOps28184 回インストール1 日前に更新

リポジトリ

alibabacloud-liverecord-diagnosis について

Alibaba Cloud ApsaraVideo Liveの録画トラブルを診断するエージェントスキルです。録画設定、ライブストリーム、コールバック記録を調べて対処を提案しますが、設定自体は変更しません。

主な機能

01録画内容とインデックスファイルの確認
02OSS・VOD録画設定の検証
03コールバック設定とイベントの調査
04配信状態と音声・映像フレームレートの確認
05調査結果に基づく診断の提案

活用シーン

01ライブ配信の録画ファイルが生成されない場合
02録画に音声または映像がない場合
03録画ステータスのコールバックが届かない場合
04録画設定と配信品質を確認する場合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-liverecord-diagnosis

インストール後、Claude Code で/alibabacloud-liverecord-diagnosisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

acceptance-criteria.md

api-response-examples.md

cli-installation-guide.md

diagnostic-report-template.md

error-codes.md

ram-policies.md

related-commands.md

verification-method.md

詳細

Alibaba Cloud ライブ録画診断スキル

シナリオの説明

このスキルは、Alibaba Cloud ApsaraVideo Live の録画に関する問題を包括的に診断します。次のような問題の特定とトラブルシューティングに役立ちます。

ライブストリームが録画されない
録画ファイルが生成されない
録画ファイルが期待どおりでない（音声や映像が欠落している、形式が異なるなど）
録画コールバックが届かない、または内容が正しくない
その他のライブ録画関連の問題

アーキテクチャ：ApsaraVideo Live + OSS/VOD + 録画設定 + コールバック設定

診断範囲

対象範囲：

ライブストリームが録画されない
録画ファイルが生成されない、または不完全である
録画ファイルに音声トラックまたは映像トラックがない
録画コールバックの問題（届かない、データが正しくない）
録画設定の検証
録画に影響するストリーム品質の問題

対象外：

ライブ録画と無関係な問題（Alibaba Cloud 公式 AI アシスタントを使用してください）
ユーザー設定の作成・変更（ユーザー自身がコンソールまたは CLI で変更する必要があります）

インストール

事前確認：Aliyun CLI 3.3.3 以降が必要です

aliyun version を実行して、バージョンが 3.3.3 以降であることを確認してください。未インストールの場合、またはバージョンが古い場合は、詳しいインストール手順について references/cli-installation-guide.md を参照してください。

事前確認：Aliyun CLI プラグインの更新が必要です

[MUST] aliyun configure set --auto-plugin-install true を実行して、自動プラグインインストールを有効にしてください。 [MUST] aliyun plugin update を実行して、既存のプラグインを常に最新の状態にしてください。

Live プラグインのインストール：

aliyun plugin install --names live

認証

事前確認：Alibaba Cloud の認証情報が必要です

セキュリティルール：

AK/SK の値を読み取ったり、エコーしたり、出力したりしては絶対にいけません（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止されています）

会話中またはコマンドラインで、ユーザーに AK/SK を直接入力するよう求めては絶対にいけません

リテラルの認証情報を指定して aliyun configure set を使用しては絶対にいけません

認証情報の状態確認には aliyun configure list のみを使用してください
aliyun configure list
出力に有効なプロファイル（AK、STS、または OAuth ID）があることを確認してください。

有効なプロファイルがない場合は、ここで必ず停止してください。

Alibaba Cloud コンソールから認証情報を取得します

このセッションの外部で認証情報を設定します（ターミナルで aliyun configure を実行するか、シェルプロファイルで環境変数を設定します）

aliyun configure list に有効なプロファイルが表示されたら、戻って再実行します

RAM ポリシー

この診断スキルには、次の RAM 権限が必要です。ポリシー文書の全文については、references/ram-policies.md を参照してください。

必要なアクション：

live:DescribeLiveDomainMapping - ドメインマッピングの照会
live:DescribeLiveStreamRecordContent - 録画コンテンツの照会
live:DescribeLiveStreamRecordIndexFiles - 録画インデックスファイルの照会
live:DescribeLiveRecordConfig - 録画設定の照会
live:DescribeLiveRecordVodConfigs - VOD 録画設定の照会
live:DescribeLiveRecordNotifyConfig - コールバック設定の照会
live:DescribeLiveStreamsOnlineList - オンラインストリームの照会
live:DescribeLiveStreamsPublishList - ストリーム配信履歴の照会
live:DescribeLiveCenterStreamRateData - ストリームレートデータの照会
live:DescribeLiveRecordNotifyRecords - コールバック記録の照会

[MUST] 権限エラーへの対応： 実行中のいずれかの時点で、権限エラーによりコマンドまたは API 呼び出しが失敗した場合は、次の手順に従ってください。

references/ram-policies.md を読み、この SKILL に必要な権限の一覧を確認します

ram-permission-diagnose スキルを使用して、必要な権限の申請をユーザーに案内します

必要な権限が付与されたことをユーザーが確認するまで待機します

パラメーターの確認

重要：パラメーターの確認 — コマンドまたは API 呼び出しを実行する前に、ユーザーがカスタマイズできるすべてのパラメーター（ドメイン名、ストリーム名、アプリケーション名、時間範囲、リージョン ID など）をユーザーに確認する必要があります。ユーザーの明示的な承認なしに、値を推測したりデフォルト値を使用したりしないでください。Alibaba Cloud Live API または CLI では、タイムゾーンが UTC の場合があります。API／CLI を呼び出す際は、ユーザーの現地時間から時刻を変換してください。

必須パラメーター：

パラメーター名	必須／任意	説明	デフォルト値
`live-stream-url`	必須	診断するライブストリーム URL（DomainName、AppName、StreamName の抽出に使用）	N/A
`issue-description`	必須	録画に関する問題の説明	N/A
`time-range`	任意	診断する時間範囲（形式：YYYY-MM-DD HH:mm:ss、ユーザーの現地時間）	過去 1 日間（データがない場合は 7 日間に拡大）
`biz-region-id`	任意	ビジネスリージョン ID	CLI 設定のデフォルトリージョン

コアワークフロー

コアワークフローの開始時（CLI を呼び出す前）に： 【必須】AI モードを有効にする — エージェントスキルを実行するには AI モードが必要です。 CLI を呼び出す前に、次のコマンドを実行してください：
aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-liverecord-diagnosis"

ステップ 1：ユーザーの意図を特定し、情報が不足していないか確認する

1.1 診断対象の確認

問題が診断対象の範囲内かどうかを確認します：

ライブストリームが録画されない
録画ファイルが生成されない
録画ファイルが期待どおりではない
コールバックの問題
その他の録画関連の問題

対象範囲外の場合は、Alibaba Cloud サポートに問い合わせるか、公式 AI アシスタントを利用するよう、丁寧にユーザーに案内してください。

1.2 必要な情報の抽出

ライブストリーム URL（例：rtmp://example.com/live/stream123）から、次の情報を抽出します：

DomainName：メイン再生ドメイン（例：example.com）
AppName：アプリケーション名（例：live）
StreamName：ストリーム名（例：stream123）

1.3 時間範囲の決定

ユーザーが時間範囲を指定した場合は、それを使用します。年が指定されていない場合は、現在の年を使用します
指定がない場合は、過去 1 日間をデフォルトとして使用します
1 日間にデータが見つからない場合は、7 日間に拡大します

1.4 ユーザーにパラメーターを確認する

抽出したパラメーターを提示し、ユーザーに確認してもらいます：

Diagnostic Parameters:
- Domain: play.example.com
- Application: live
- Stream: stream123
- Time Range: 2026-01-20T00:00:00Z to 2026-01-21T00:00:00Z

Please confirm these parameters are correct before proceeding.

ステップ 2：ドメインマッピングと録画結果を照会する

ユーザーの問題を検証するため、このセクションの手順を必ず実行してください。

2.1 ドメインマッピングの照会

まず、ドメインマッピングを照会してメイン再生ドメインを取得します：

aliyun live describe-live-domain-mapping \
  --domain-name <DomainName>

応答形式については、期待される出力を参照してください。メイン再生ドメイン（Type: vhost）を抽出し、以降の照会で使用します。

2.2 録画コンテンツの照会

前の手順の結果にかかわらず、この手順を必ず実行してください。指定した時間範囲の録画コンテンツを照会します。

aliyun live describe-live-stream-record-content \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName> \
  --start-time <StartTime> \
  --end-time <EndTime>

応答形式については、期待される出力を参照してください。

2.3 録画インデックスファイル（OSS）の照会

OSS に録画している場合は、インデックスファイルを照会します：

aliyun live describe-live-stream-record-index-files \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName> \
  --start-time <StartTime> \
  --end-time <EndTime>

応答形式については、期待される出力を参照してください。

2.4 ユーザーの問題を検証する

照会結果とユーザーから報告された問題を比較します：

録画が存在するのにユーザーが録画されていないと報告している場合 → アクセスまたは再生に問題がある可能性があります
録画が見つからない場合 → ステップ 3 に進み、設定を確認します
録画は存在するものの不完全な場合 → ステップ 5 でストリーム品質を確認します

ステップ 3：録画設定の照会

録画から VOD／OSS への設定では、アプリ名やストリーム名にワイルドカード（*）を指定できるものがあります。複数の設定がある場合は、最も一致度の高い設定を使用してください。

3.1 OSS への録画設定を照会する

aliyun live describe-live-record-config \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName>

レスポンス形式については、期待される出力を参照してください。

録画設定の OnDemand フラグは、録画タスクを開始できるかどうかに影響します。値は次のとおりです。

0：自動録画
1：通知設定の OnDemandUrl を呼び出して、録画を開始するかどうかを判断します
7：手動録画。録画の開始／停止は、ユーザーが RealTimeRecordCommand OpenAPI を呼び出して手動で行う必要があります

検証チェックリスト：

✅ ストリームに設定が存在する
✅ OssBucket と OssEndpoint が正しい
✅ RecordFormat に必要な形式（m3u8、flv、mp4）が含まれている
✅ OssObjectPrefix が適切に設定されている

3.2 VOD への録画設定を照会する

aliyun live describe-live-record-vod-configs \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName>

レスポンス形式については、期待される出力を参照してください。

検証チェックリスト：

✅ ストリームに設定が存在する

3.3 診断結果

設定が存在しない場合：ストリームの開始前に録画設定を作成するようユーザーに伝えてください。参照先：https://help.aliyun.com/live/user-guide/live-stream-recording
設定に誤りがある場合：具体的な問題を特定し、コンソールまたは CLI から更新するようユーザーに案内してください。
設定が正しい場合：コールバック設定の確認に進んでください。
OnDemand が 7 の場合：ライブストリーム情報の確認に進み、ストリームがある場合は、RealTimeRecordCommand OpenAPI を呼び出すようユーザーに伝えてください。

ステップ 4：コールバック設定の照会

ユーザーの質問がコールバックに関するものでない場合は、このステップをスキップしてください。

4.1 録画コールバック設定を照会する

aliyun live describe-live-record-notify-config \
  --domain-name <PlaybackDomain>

レスポンス形式については、期待される出力を参照してください。

検証チェックリスト：

✅ NotifyUrl が設定されている（コールバックに必須）
✅ NeedStatusNotify が有効になっている（ステータスコールバック用）
✅ OnDemandUrl が設定されている（オンデマンド録画用）

4.2 診断結果

NotifyUrl が設定されていない場合：コールバック URL を設定するようユーザーに伝えてください。
NotifyUrl は設定されているが NeedStatusNotify が false の場合：ステータスコールバック用に NeedStatusNotify を有効にするよう案内してください。
設定が正しい場合：ストリーム情報の確認に進んでください。

ステップ 5：ライブストリーム情報の照会

5.1 オンラインストリームの照会

ストリームが現在オンラインかどうかを確認します。

aliyun live describe-live-streams-online-list \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName>

レスポンス形式については、期待される出力を参照してください。

5.2 過去のストリーム配信記録の照会

過去の配信記録を確認します。

aliyun live describe-live-streams-publish-list \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName> \
  --start-time <StartTime> \
  --end-time <EndTime>

レスポンス形式については、期待される出力を参照してください。

5.3 ストリームレートデータの照会（音声／映像のフレームレート）

オンラインまたは配信中のストリーム記録がある場合は、音声と映像のフレームレートを確認して、品質上の問題を特定します。

aliyun live describe-live-center-stream-rate-data \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName> \
  --start-time <StartTime> \
  --end-time <EndTime>

レスポンス形式と分析の指針については、期待される出力を参照してください。

5.4 診断結果

配信記録が見つからない場合：ストリームが正しい URL にプッシュされているか確認するようユーザーに伝えてください：rtmp://<push-domain>/<app-name>/<stream-name>
ストリーム品質の問題（例：AudioFrameRate=0）が検出された場合：ストリーミングソースの音声／映像エンコードが適切か確認するよう案内してください。
ストリーム情報に問題がない場合：コールバック記録の確認に進んでください。

ステップ 6：録画コールバックレコードの照会

6.1 録画コールバックイベントの照会

録画に関する問題を特定するため、コールバックレコードを照会します。

ユーザーの質問がコールバックレコードに関するものであれば、前のステップの結果にかかわらず、コールバックレコードを必ず照会してください。

aliyun live describe-live-record-notify-records \
  --domain-name <PlaybackDomain> \
  --app-name <AppName> \
  --stream-name <StreamName> \
  --start-time <StartTime> \
  --end-time <EndTime> \
  --page-size <PageSize, e.g. 20> \
  --page-number <PageNumber, e.g. 1>

応答形式については、期待される出力を参照してください。

6.2 コールバックイベントの分析

録画イベントの種類：

record_started - 録画が正常に開始されました
record_paused - 録画が一時停止／停止されました
record_error - 録画エラーが発生しました
transformat_error - トランスコードエラー（MP4/FLV の場合）

詳細なエラーコード、解決手順、診断結果については、references/error-codes.mdを参照してください。

6.3 診断結果

コールバックイベントに基づいてエラーコードを特定し、references/error-codes.mdに記載されている解決方法に従ってください。

エラーが見つからない場合：

✅ No recording errors found in callback records.

If you're still experiencing issues, please provide more details about the specific problem.

ステップ 7：診断レポートの生成

すべての診断ステップを完了したら、references/diagnostic-report-template.mdのテンプレートを使用して、包括的なレポートを生成します。

レポートには、次の内容を含めてください。

ストリーム情報（ドメイン、アプリ、ストリーム、時間範囲）
各ステップの診断結果（ドメインマッピング、録画コンテンツ、設定、コールバック、ストリーム、品質、イベント）
根本原因の概要
必要な対応事項
推奨される次のステップ

[MUST] あらゆる終了時点で AI-Mode を無効にしてください — 理由を問わず最終応答を返す前に、必ず AI-mode を無効にしてください。これは、ワークフローの成功、ワークフローの失敗、エラー／例外、ユーザーによるキャンセル、セッションの終了、または今後 CLI コマンドが実行されないその他すべての状況に適用されます。 AI-mode は Agent Skill の呼び出し時にのみ使用します。スキルの実行終了後も有効なままにしてはいけません。
aliyun configure ai-mode disable

成功の確認方法

診断ワークフローの完了後、次の項目を確認します。

録画設定の確認：録画設定が存在し、正しいことを確認します
コールバック設定の確認（任意）：ユーザーの質問がコールバックに関するもの、または必要な場合は、コールバック URL が設定されていることを確認します
ストリーム状態の確認：ストリームが配信されていることを確認します
コールバックレコードの確認：エラーイベントがないか確認します
録画ファイルの確認：OSS または VOD にファイルが存在することを確認します

詳細な確認手順とコマンドについては、references/verification-method.mdを参照してください。

クリーンアップ

この診断スキルではリソースを作成しないため、クリーンアップは不要です。

注：このスキルは読み取り専用で、設定を変更することはありません。設定を変更する必要がある場合は、コンソールまたは CLI から変更してください。

ベストプラクティス

まずドメインマッピングを必ず確認する - 正しい再生ドメインを照会していることを確認します
適切な時間範囲を使用する - まず 1 日間を指定し、必要に応じて 7 日間に拡張します
ストリーム開始前に録画設定を確認する - ストリームをプッシュする前に、録画設定を作成しておく必要があります
ステータスコールバックを有効にする - 詳細な録画イベントを受信するには、NeedStatusNotify=true を設定します
コールバックイベントを定期的に監視する - エラーイベントを確認し、問題を早期に特定します
OSS の権限を確認する - ApsaraVideo Live が OSS バケットにアクセスできることを確認します
ストリーム品質を確認する - 適切にエンコードされていることを確認するため、音声／映像のフレームレートを監視します
正しいドメイン種別を使用する - 録画 API には、取り込みドメインではなくメインの再生ドメインが必要です
録画セグメントの完了を待つ - 録画はセグメントの長さ（例：3600 秒）に達した後に書き込まれます
まずシンプルなストリームでテストする - 複雑なシナリオをテストする前に、基本的なストリームで設定を確認します

参考リンク

参考資料	説明
references/ram-policies.md	このスキルに必要なRAM権限の完全な一覧
references/related-commands.md	このスキルで使用するCLIコマンドの完全な一覧
references/verification-method.md	詳細な検証手順とコマンド
references/error-codes.md	録画エラーコードと解決策の完全な一覧
references/cli-installation-guide.md	Alibaba Cloud CLIのインストールおよび設定ガイド
references/api-response-examples.md	診断コマンドのAPIレスポンス形式の例
references/diagnostic-report-template.md	診断レポートのテンプレートと例

その他のリソース

Markdown 対応

ログインしてコメント

基本情報

作者: aliyun
リポジトリ: aliyun/alibabacloud-aiops-skills
カテゴリ: クラウド・DevOps
インストール数: 84
GitHub スター: 281

問題を報告