モバイル¶
Guance App は、モバイルデバイスでワークスペース内のインシデント、観測データ、オンコールスケジュール、アカウント設定を確認・処理できます。App は現在、「ホーム」「観測」「インシデント」「オンコール」「マイページ」の 5 つのエントリーを中心に機能を構成しています。アラートやコラボレーション通知を受け取ったら、すぐにインシデント詳細に移動し、ログ、トレース、イベント、RUM、ダッシュボードのデータを確認できます。また、ステータス遷移、コラボレーションコメント、リンク共有、Handoff による引き継ぎで問題を引き続き処理できます。
インストール¶
Guance のワークスペース内では、「インテグレーション」→「モバイル」からダウンロードできるほか、以下の QR コードをスキャンしてダウンロードすることもできます。
または、以下のリンクから直接ダウンロードすることもできます。
ログイン¶
既存のGuanceの無料/商用プランユーザーは、App でアカウントが所属するサイトを選択し、パスワード、SMS 認証コード、または SSO でログインできます。サイト一覧は現在の製品ラインに応じて表示され、ログインページでサイト情報を更新することもできます。
- パスワードログイン:メールアドレスまたはアカウントとパスワードを入力してログインします。アカウントを記憶するか選択できます。
- 認証コードログイン:携帯電話番号と 6 桁の認証コードを入力してログインします。認証コードの送信前に画像認証の完了が必要な場合があります。
- SSO ログイン:メールアドレスまたは完全な SSO アドレスを入力し、ページの指示に従ってログインエントリーとワークスペースを選択してシングルサインオンを完了します。
- パスワードを忘れた場合:パスワードログインページからパスワード再設定のフローに進み、アカウント検証を完了した後に新しいパスワードを設定します。
- MFA:ワークスペースで MFA セキュリティポリシーが有効になっている場合、ログイン時またはワークスペースの切り替え時に、ページの指示に従って検証を完了する必要があります。初回バインド時にはバインドのフローも表示されます。
まだGuanceアカウントをお持ちでない場合は、Guance公式サイトの今すぐ申し込む から、適切なサイトのアカウントを選択して登録できます。
ログインに成功すると、App は現在のアカウントがアクセスできるデフォルトのワークスペースに入ります。「ホーム」「観測」「インシデント」「オンコール」「マイページ」でワークスペースを切り替えられます。切り替えると、各ページのデータは新しいワークスペースに基づいて再読み込みされます。
プライベートサイトでのログイン¶
チームがプライベートデプロイサイトを使用している場合は、ログインページのサイトセレクターでプライベートサイトを追加し、該当サイトでログインを完了できます。
プライベートサイトを追加
- ログインページで「サイト」をクリックし、サイトセレクターを開きます。
- 「プライベートサイトを追加」をクリックします。
- 「ターゲットアドレス」にプライベートサイトの Console アドレスまたはサイトディレクトリアドレスを入力します。例:
https://console.company.comまたはhttps://urls.company.com/。 - 「認識してプレビュー」をクリックすると、App がサイト名、Console アドレス、API アドレス、サポートされているログイン方法を自動的に認識します。
- サイト名を確認して「追加して保存」をクリックします。複数のサイトが認識された場合は、ページの指示に従ってログインページでデフォルトで使用するサイトを選択してください。
保存に成功すると、プライベートサイトはサイトセレクターの「プライベート」グループに表示されます。目的のサイトを選択すると、パスワード、認証コード、または SSO でログインできます。利用可能なログイン方法は、そのプライベートサイトの設定によって異なります。
プライベートサイトを管理
プライベートサイトを追加した後、ログインページのサイトセレクターで「プライベートサイトを管理」をクリックすると、リモートディレクトリの更新、デフォルトサイトの切り替え、不要になった設定の削除、トラブルシューティング用の診断情報のコピーができます。リモートディレクトリの更新に失敗した場合、App は最後に同期に成功したローカルキャッシュを優先的に使用します。
サイトディレクトリアドレスの形式
サイトディレクトリアドレスを使用する場合、ディレクトリアドレスは App がアクセス可能な HTTPS URL である必要があります。例:https://urls.company.com/ または https://urls.company.com/site-map.json。プロトコルなしで入力した場合や http:// アドレスを入力した場合、App は https:// に変換してからアクセスします。このアドレスが返す内容は JSON オブジェクトである必要があり、最上位に urls フィールドが含まれている必要があります。urls 配下の各 key が 1 つのサイトを表し、サイト内で Console と API のアドレスを提供する必要があります。
以下に例を示します。
{
"urls": {
"prod": {
"name": "公司生产环境",
"name_en": "Company Production",
"console": "https://console.company.com",
"console_api": "https://console-api.company.com"
},
"staging": {
"name": "公司预发环境",
"name_en": "Company Staging",
"console": "https://staging-console.company.com",
"console_api": "https://staging-console-api.company.com"
}
}
}
ここで、name と name_en はサイト名の表示に使用され、console は Web コンソールのアドレス、console_api は業務 API のアドレスです。
注意:プライベートサイトのアドレスは、現在のネットワーク環境で HTTPS 経由でアクセスできる必要があります。認識に失敗した場合は、アドレスが有効な Console アドレスまたはサイトディレクトリアドレスかどうかを確認し、ネットワーク、VPN、証明書、サイト設定を確認してください。
ホーム¶
「ホーム」には、現在対応が必要なインシデントが集約されます。現在のワークスペース内の未割り当てインシデントと、あなたに割り当てられていて未解決のインシデントが含まれます。ホームでは以下の操作をすばやく実行できます。
- インシデント名、重大度、ステータス、担当者、更新時刻、オンコール情報を確認できます。
- 最近の時間または正確な時間範囲を選択して、特定の期間内のインシデントを特定できます。
- プルダウンで現在のワークスペースのインシデント一覧を更新できます。
- インシデントを長押しして複数選択モードに入り、一括で引き受けたり、解決済みにマークしたり、インシデントステータスを変更したりできます。
- インシデントカードをクリックして詳細ページに移動し、調査とコラボレーションを続行できます。
- ワークスペースを切り替えて、ホームのデータを再読み込みできます。
現在のワークスペースに未処理のインシデントがない場合、ホームには空状態のメッセージが表示されます。
観測¶
「観測」は、ダッシュボード、ログ、トレース、イベント、RUM のモバイル向け検索エントリーを提供します。モバイルデバイスで重要なデータをすばやく確認できるほか、共有リンクや Handoff から対応するデータ詳細に移動できます。
ダッシュボード¶
「観測」→「ダッシュボードを表示」では、現在のワークスペースでアクセス可能なダッシュボードの一覧を確認できます。ダッシュボードは、名前による検索、クイックフィルター、タグフィルター、お気に入り登録、作成・更新情報の確認に対応しています。ダッシュボードの詳細に入ると、以下が可能です。
- ダッシュボード内のチャート、テーブル、トップリスト、値、テキストなどのコンポーネントを確認できます。
- 時間ウィジェットで最近の時間または正確な時間範囲を切り替えられます。
- ダッシュボード変数を調整し、サービス、ホスト、アプリケーションなどのディメンションでデータを切り替えられます。
- コンポーネント名を検索して、目的のチャートをすばやく見つけられます。
- チャート概要とチャート閲覧モードを切り替え、グループごとにチャートを展開または折りたたむことができます。
- 単一のコンポーネントを拡大し、共有するか、Handoff で対応するコンソールリンクを開くことができます。
ダッシュボードは Web 版と内容が同期されます。詳細は ダッシュボード を参照してください。
ログ、トレース、イベント、RUM の検索¶
「観測」では、ログ、トレース、イベント、RUM の各検索ページにそれぞれ移動できます。
- ログ:ログインデックスを選択し、キーワードまたは
key:value条件でログレコードを検索して、ログ詳細でフィールドの内容を確認できます。 - トレース:
trace_id、サービス、ステータスなどの条件で Trace を検索し、ウォーターフォールチャートで Span の呼び出し関係を確認できます。 - イベント:主要なイベントの詳細を確認でき、イベント ID、モニターのフィールドなどの条件でイベントを特定できます。
- RUM:View、Action、Resource、Long Task、Error などのタイプでユーザーアクセスデータを確認でき、詳細で Trace や Resource に関連付けることができます。
検索ページは、最近の時間、正確な時間、フィールド候補、値の候補に対応しています。レコードの詳細を開くと、サマリー、フィールドリスト、元の内容を確認でき、コンソールリンクを共有できます。Trace のウォーターフォールチャートでは、関連する RUM Resource の確認や、個々の Span の詳細への移動もできます。
ログ検索と詳細:
トレース検索とウォーターフォールチャート:
イベント検索と詳細:
RUM 検索と詳細:
インシデント¶
「インシデント」では、現在のワークスペース内のインシデントを確認、検索、引き受け、追跡できます。インシデント一覧はステータスで切り替えられ、一般的なステータスには未割り当て、処理中、解決済みなどがあります。
インシデント一覧では、以下が可能です。
- 最近の時間または正確な時間でインシデントをフィルターできます。
- キーワードまたは
key:value条件を入力してインシデントを検索できます。 - 検索候補を使用して、タイトル、重大度、ステータス、サイト、ホスト、担当者などのフィールドをすばやく選択できます。
- 「自分に関連」フィルターを有効にして、あなたに通知された、あなたに割り当てられた、またはあなたのオンコールルールに関連するインシデントを優先的に表示できます。
- 長押しで複数選択モードに入り、インシデントステータスを一括更新できます。
- ワークスペースを切り替えて、現在のワークスペースのデータを更新できます。
インシデント詳細¶
インシデント詳細に入ると、インシデントのコア情報、ステータス遷移、調査のコンテキストを確認できます。詳細ページでは、以下が可能です。
- インシデントのタイトル、重大度、ステータス、担当者、サイト、検出ディメンション、関連タグを確認できます。
- イベント分布を確認して、同じインシデントが異なるステータスでどのように分布しているかを把握できます。
- インシデントを処理中として引き受ける、解決済みにマークする、再オープンする、または処理を放棄できます。
- 「詳細」「フィールド」「コラボレーション履歴」などのセクションを表示できます。
- コラボレーション履歴で操作タイムライン、コメント、システム変更を確認でき、コメントのみの表示に切り替えられます。
- コメントを入力し、@メンションでワークスペースメンバーに通知し、ファイルを添付できます。
- 共有または Handoff を使用して、モバイル端末と PC で同じインシデントを引き続き確認できます。
インシデントのプッシュ通知やコラボレーションでの @メンションを受け取った場合、通知をクリックして該当のインシデントに移動できます。通知がコラボレーションコメントを指している場合、App はコラボレーションエリアに移動し、対象のコメントをハイライトします。
オンコール¶
「オンコール」では、現在のワークスペース内のオンコールスケジュールを確認できます。月ごとにオンコールグループと日ごとのオンコール担当メンバーを確認でき、オンコール詳細で現在のオンコール担当、次回のオンコール担当、履歴を確認できます。
オンコールページでは、以下が可能です。
- 現在の月にアクセス可能なオンコールグループを確認できます。
- 当日のオンコール担当者を確認できます。
- カレンダーで日付ごとのオンコールスケジュールを確認できます。
- メンバーのオンコール詳細を開き、オンコール中、次回のオンコール、オンコール履歴を確認できます。
- メンバーのオンコール連絡先を確認できます。携帯電話番号やメールアドレスなど、設定済みの情報が含まれます。
- オンコールのエスカレーションポリシー、通知レベル、通知方法、通知先を確認し、アラートがどのようにオンコール担当メンバーに届くかを把握できます。
- ワークスペースを切り替えて、オンコールデータを再読み込みできます。
マイページ¶
「マイページ」では、アカウント、ステータス、ワークスペースのコラボレーション、通知、App 設定を管理できます。
アカウントとステータス¶
「マイページ」では、現在のアカウント、メールアドレス、携帯電話番号、アバター、現在のワークスペースを確認できます。また、自分の作業ステータスを設定したり、本日のオンコール概要を確認したりできます。オンコール状態はスケジュールによって決まり、App は現在のオンコールスケジュールに基づいて、あなたがオンコール中かどうかを表示します。
ワークスペースの切り替え¶
Guance App は、アカウントがアクセス権限を持つすべてのワークスペースのデータを表示できます。「ホーム」「観測」「インシデント」「オンコール」「マイページ」でワークスペースセレクターを開き、ワークスペースを検索して切り替えられます。
現在ワークスペースがない場合は、Guance Web 版で新しいワークスペースを作成するか、他のワークスペースのワークスペース管理者に新しいメンバーとして招待してもらってください。
ワークスペースメンバー¶
「マイページ」→「ワークスペースメンバー」では、現在のワークスペースのメンバーを確認でき、名前、メールアドレス、アカウントでメンバーを検索したり、メンバー詳細を確認したりできます。インシデントのコラボレーションコメントでの @メンションも、ワークスペースメンバーの情報を使用します。
メッセージ通知¶
Guance App は、ワークスペースのアラートとインシデントのコラボレーションに基づくモバイルプッシュ機能を提供します。「マイページ」→「設定」→「プッシュ設定」で、システム通知権限を確認し、App のプッシュをオン/オフにしたり、通知の設定を管理したりできます。
プッシュ設定では、自分に関連するインシデントのみ通知する、未割り当てインシデントのアラートを受け取る、処理中のインシデントのステータス変更を受け取るなどの設定が可能です。システム通知権限が有効になっていない場合は、iOS のシステム設定で通知を許可してください。
ダッシュボードショートカット¶
Guance App は、ダッシュボードのホーム画面ショートカットを設定できます。設定後、iOS のホーム画面で App アイコンを長押しすると、指定したダッシュボードを直接開けます。各ワークスペースで最大 4 つのダッシュボードショートカットを設定できます。
「マイページ」→「設定」→「ダッシュボードショートカット」で、すばやく表示したいダッシュボードを検索して選択できます。また、選択済みのショートカットの順序を変更したり、不要になったショートカットを削除したりできます。
言語、外観、アカウントのセキュリティ¶
「マイページ」→「設定」では、以下の項目も設定できます。
- 言語設定:システムに従う、簡体字中国語、繁体字中国語、English から選択できます。
- 外観設定:システムに従う、ライトモード、ダークモードから選択できます。
- アカウントのセキュリティ:現在のログイン方法、サイト、ワークスペース、最終ログイン時刻、ローカル認証情報の保存について確認できます。
- デバッグ情報:ログイン、サイト、プッシュ登録のトラブルシューティングに使用するデバイス情報を確認できます。トークンやシークレットキーは表示されません。
- ローカルデータとキャッシュ:ローカルのログイン情報、アバターキャッシュをクリアするか、すべてのローカルデータをクリアできます。
- ログアウト:現在のデバイスのセッションを終了してログインページに戻ります。
共通機能¶
時間ウィジェット¶
Guance App は、時間ウィジェットを使用して、ホームのインシデント、観測クエリ、ダッシュボードに表示する時間範囲を設定できます。直近 1 分、5 分、15 分、1 時間、1 日、7 日などのプリセット時間を選択できるほか、開始時刻と終了時刻を選択して正確なクエリを実行することもできます。
検索とフィルター¶
インシデント、ログ、トレース、イベント、RUM、ダッシュボードの一覧では、検索とフィルターを使用して目的のデータをすばやく特定できます。一部のページでは key:value フィールド条件、フィールド候補、値の候補に対応しています。フィールドフィルターの詳細は、ドキュメント 検索の説明 を参照してください。
共有¶
Guance App は、インシデント詳細、ダッシュボード、観測データの詳細、チャート拡大ページでコンソールリンクを共有できます。ページ内の「共有」ボタンをクリックすると、他のコラボレーションメンバーにリンクを送信できます。
注意:共有リンクの内容を確認するには、相手にも共有内容が属するワークスペースへのアクセス権限が必要です。
シナリオ 1:PC へ共有
このシナリオでは、受け取った共有リンクをクリックすると、PC でログインして対応するデータを確認できます。
シナリオ 2:Guance App がインストールされた iOS または Android モバイルデバイスへ共有
このシナリオでは、受け取った共有リンクをクリックすると、App 内の対応するデータページを開けます。対象サイトが現在ログインしているサイトと異なる場合、App はサイトの切り替えまたは再ログインを促します。
リンク遷移¶
iOS または Android デバイスにGuance App がインストールされている場合、どこでGuanceの Web リンクを開いても、App 内の対応するコンテンツのページに遷移できます。これには DingTalk、Lark、メール内のアラート通知も含まれます。
現在、リンクからインシデント、ダッシュボード、ログ、トレース、イベント、RUM などの関連ページを開くことができます。リンクにサイトまたはワークスペースの情報が含まれている場合、App は対象のコンテキストに入ろうとします。対象サイトが現在ログインしているサイトと異なる場合は、サイトの切り替えと再ログインを促します。現在のアカウントに対象ワークスペースへのアクセス権限がない場合は、アカウントの権限を確認してください。
Handoff¶
Guance App は、Handoff を使用してモバイル端末と PC の間でインシデントと観測データを同期表示できます。アラートの処理、問題の調査、コラボレーションによるフォローアップの際に、デバイスをすばやく切り替えるのに役立ちます。
注意:Handoff を使用するには、PC 側が macOS、モバイルデバイス側が iOS である必要があります。各デバイスで Handoff 機能を有効にし、同じ Apple ID で iCloud にログインする必要があります。App がインストールされておりログイン済みであること、現在のアカウントに対象ワークスペースの権限があることも必要です。詳細な設定は、ドキュメント Handoff の使用方法 を参照してください。
現在 Handoff に対応しているページは、インシデント詳細、ダッシュボード詳細、拡大したダッシュボードチャート、ログ/イベント/RUM などの観測レコード詳細、トレースのウォーターフォールチャート、トレース Span 詳細です。App は現在のページに対応するコンソール URL を公開するため、別のデバイスで同じデータを引き続き確認できます。
シナリオ 1:モバイル端末でデータを確認し、PC で処理を続行
このシナリオでは、モバイル端末で Handoff 対応のインシデントまたは観測データのページを確認しているとき、macOS の Dock に Guance App の同期表示プロンプトが表示されます。プロンプトをクリックすると、ブラウザで対応するコンソールページを開けます。
シナリオ 2:PC でデータを確認し、モバイル端末で処理を続行
このシナリオでは、PC でモバイル端末から開けるデータリンクを確認しているとき、iOS デバイスの下部に Guance App の同期表示プロンプトが表示されます。プロンプトをクリックすると、App 内の対応するデータページを開けます。対象サイトまたはワークスペースが現在のコンテキストと異なる場合、App はサイトの切り替え、再ログイン、またはワークスペース権限の確認を促します。



























