Confluence Cloud Migration Assistant を利用してご利用のインスタンスの規模を評価する: データベース クエリと利用状況のメトリクス
ユーザー数、スペース数、ページ数などの、コンテンツに関するデータを収集することで、Confluence インスタンスの規模を評価できます。このデータをアトラシアン移行チームと共有していただくと、当社で移行の複雑さを分析し、移行計画に関するガイダンスを提供することができます。
動作の仕組み
評価はクラウド移行アシスタントの一部であり、現在はダーク機能の背後にあります。これらを有効化して評価を実行すると、次のデータが自動的に収集されます。
データベース エンティティ: スペースやページなど、エンティティの番号やメタデータ
- Macros: Confluence macros, including nested macros, and macros whose cloud equivalents work differently or don't exist at all.
使用状況のデータ: たとえば、過去数日間のアクティブ ユーザー数
ブラウザ メトリクス: ユーザーのブラウザに基づく、ネットワークの速度や品質などのパフォーマンスとブラウザ メトリクス
- トラフィック分布: ページの閲覧やコメントの追加など、ユーザーが行ったさまざまなアクションによるトラフィックの分布 (%)
データは、いくつかのファイルとともに ZIP アーカイブに保存されます。これらは分析のためにアトラシアンと共有していただく必要があるほか、ご利用のインスタンスの改善案を得るためにご自身で内容を確認することもできます。
当社でのデータの利用について
評価プロセスでは、お客様が当社と共有した Jira インスタンスに関するメタデータのみが使用されます。このメタデータには、個人を特定できる情報 (PII) は含まれません。
これにより、当社ではお客様のデータの複雑さとクラウド製品におけるパフォーマンス要件をよりよく理解し、お客様のリスクを軽減して成功へと導く移行戦略や計画を立てることができます。さらに、収集されたメタデータは、当社の製品やツールを継続的に改善するのに役立ちます。
評価を実行するには、Confluence インスタンスで機能フラグを有効化する必要があります。評価ツールはインスタンスを 24 時間監視し、その後複数の結果ファイルを出力します。この間、評価はシステムリソースを消費しません。
FAQ
よく寄せられる質問をいくつか紹介します。
個人を特定できるデータを収集していますか?
この評価では、個人を特定できるデータ (PII) は収集されません。私たちが収集するデータはすべて ID に基づいています。また、アトラシアンと自動的に共有されるわけでもありません。お客様は必要なときに当社にファイルを共有できます。
インターネット接続は必要ですか? ネットワーク外部にある API を呼び出していますか?
データの収集にインターネット接続は不要です。また、ご利用のインスタンスの外部にある API への呼び出しも行われません。
Confluence インスタンスのパフォーマンスへの影響
当社では、評価がインスタンスに影響しないようにするために、パフォーマンス テストや最適化を行っています。実行中もユーザーは Confluence で作業を続行できます。
はじめる前に
Confluence Cloud Migration Assistant をバージョン 3.9.6 以降にアップグレードする必要があります。
ご利用のインスタンスの規模を評価
ご利用のインスタンスを評価するには次の手順に従います。
1. 評価を有効化
評価を有効化するには、次の手順を実行します。
<Confluence-url>/admin/darkfeatures.action
に移動します。次のフラグを追加します。
migration-assistant.enable.assess-l1-cloud-tooling.feature
詳細については、「Confluence でダーク機能を有効にする」を参照してください。
2. 評価の実行
評価を実行してデータを収集するには、次の手順を実行します。
Confluence Cloud Migration Assistant を開きます。
[Assess your instance data] カードで [Analyze data] を選択します。
評価が開始します。次のものを含むデータが収集されます。
データベース エンティティ: データベースでクエリを実行して、ご利用のエンティティに関するデータを収集します。
- 使用状況のデータ: たとえば、過去数日間のアクティブ ユーザー数
ブラウザ メトリクス: ユーザーのブラウザからパフォーマンス データを収集します。
- トラフィック分布: ページの閲覧やコメントの追加など、ユーザーが行ったさまざまなアクションによるトラフィックの分布 (%)
3. 結果をダウンロードする
評価が完了したら、[Download ZIP file] を選択します。ZIP アーカイブには次のファイルが含まれます。
以前のバージョンのアシスタントを使用している場合は、ファイルが異なる場合があります。最新バージョンに更新することをおすすめします。
ファイル | 説明 |
---|---|
confluence-entities-[date].csv | データベースから取得された、特定のエンティティに関するデータ。ご利用のインスタンスの規模を当社で理解し、最適な移行戦略を判断するのに役立ちます。 |
confluence-macros-[date].jsonl | Confluence マクロに関するデータ。これには以下の情報が含まれます。
|
confluence-browser-metrics-[date].jsonl | インスタンスのパフォーマンスに関する、ユーザーのブラウザから取得されたデータ。これは、クラウドで最高のパフォーマンスを実現するために必要な要素を当社で理解するのに役立ちます。 |
confluence-usage-metrics-[date].csv | アクセス ログから取得された、使用状況のメトリクス。Confluence Cloud チームがお客様に最適なクラウド インスタンスを判断するのに役立ちます。 |
confluence-traffic-distribution-[date].csv | ページの閲覧やコメントの追加など、ユーザーが行ったさまざまなアクションによるトラフィックの分布 (%)。異常なトラフィックを見つけるのに役立ちます。 |
4. 結果をアトラシアンに共有
結果をアトラシアンに共有します。ほとんどの場合、このページを案内したされた MOVE チケットまたはサポート リクエストに添付することになります。
当社で出力結果を確認し、複雑さ、データの形、パフォーマンス要件、および存在している場合はリスクを把握します。これらは、お客様の移行戦略と計画の作成に役立ちます。
収集されるデータ
ファイルで確認できる、収集されたデータの詳細です。
ファイル: confluence-entities-[date].csv
このファイルには次のエンティティに関するデータが含まれます。
ユーザーの総数
一意のユーザー名を持つユーザーの数
アクティブなユーザー数
非アクティブなユーザーの数
ユーザー グループの数
ステータスごとのスペースの総数
もっとも多くの添付ファイルを持つ上位 100 スペースのそれぞれにおける添付ファイルの数
添付ファイルの合計サイズ (GB)
35,000 人以上のユーザーがいるグループのメタデータ
アクティブなユーザー グループの数
もっとも多くの添付ファイルを持つ上位 100 ページのそれぞれにおける添付ファイルの数
スペースごとの添付ファイルの数
1 ページあたりのコメントの最大数
もっとも多くのページを持つ上位 100 スペースのそれぞれにおけるページの数
1 つのスペースのページの最大数
制限のあるページの数
1 ページあたりの制限の最大数
1 ページの "いいね" の最大数
1 ページあたりのスペース権限の最大数
1 スペースあたりのスペース権限の最大数
バージョンごとのページ数
ステータスごとのページ数
もっとも多くの Jira 課題マクロを持つ上位 10,000 ページのそれぞれにおける Jira 課題マクロの数
インストールされたアプリの一覧
もっとも多くのメディアを持つ上位 50 ページのそれぞれにおけるメディアの数
もっともサイズの大きい上位 10 個の非個人スペースのサイズ (GB)
過去 180 日間に変更されたスペースのメタデータ
もっとも多くのグループを持つ上位 100 ユーザーのそれぞれにおけるグループの数
もっとも多くの添付ファイルが埋め込まれた上位 100 ページのそれぞれにおける、埋め込まれた添付ファイルの数
もっとも新しい添付ファイルを持つ上位 100 ページのそれぞれにおける現在の添付ファイルの数
スペースのユーザー権限の最大数
データベース テーブルのサイズ (GB)
データベースのサイズ (GB)
メディア サイズ (GB)
もっとも多くの表を持つ上位 50 ページのそれぞれにおける表の数
ページ ステータスごとのページ数
添付ファイルの合計サイズ (GB)
もっとも多くの表を持つ上位 50 ページのそれぞれにおける表のサイズ (GB)
非アクティブなユーザーの個人スペースのメタデータ
1 つのページの子ページの最大数
1 つのページの子ページの最大深度
もっとも多くの表のセルを持つ上位 50 ページのそれぞれにおける表のセルの数
もっとも大きなデータ サイズを持つ上位 10 個の非個人スペースのメタデータ
もっとも大きなデータ サイズを持つ個人スペースのメタデータ
ファイル: confluence-macros-[date].csv
このファイルには、移行後に完全な互換性を失う Confluence マクロに関する情報が含まれています。 マクロはスペースごとに表示され、次の種類があります。
- differentMacros: 同等のものがクラウドに存在するが、機能に多少の違いがあるマクロ
- notAvailableMacros: クラウドには存在せず、移行後は機能しなくなるマクロ
- nestedMacros: Macros that have other macros nested inside
一覧の各マクロについて、名前、詳細、数、およびそれらのマクロが表示されるページの URL を確認できます。
ファイル: confluence-browser-metrics-[date].jsonl
user ID: ユーザーの一意の識別子。プライバシーを守りつつ、弊社側でユーザーとのやりとりを追跡できるようにするために、安全に生成され、ランダムにハッシュ化されます。
Browser type and version: ブラウザの詳細。Google Chrome、Safari など。
Operating system: オペレーティング システムの詳細。Windows、MacOS など。
Processor count: デバイス上のプロセッサの数。
System memory (RAM): デバイス上のメモリまたは RAM の総容量。
Network download speed: データのダウンロード速度。
Network connection quality: ネットワーク接続の有効性。
Network Latency (RTT): ラウンド トリップ時間 (RTT) は、信号がユーザーのコンピューターから Confluence インスタンスに伝わり、戻ってくるまでにかかる時間の測定値です。これは、ユーザーのネットワーク接続の応答性を測定するのに役立ちます。
ファイル: confluence-usage-metrics-[date].csv
Interactions date: Confluence インスタンスの操作がアクセス ログに記録された日付。
Active users per day: 過去 14 日間に Confluence インスタンスを操作した一意のユーザーの数。
Peak-hour active users per day: Confluence インスタンスを同時に操作した一意のユーザーの数。ユーザー ID と、それに対応する日付と時間の組み合わせとをアクセス ログに集約することで取得しています。インスタンスのもっとも忙しい時期のスナップショットを提供します。
Node availability and data collection status: 各ノード (または単一ノード) の可用性のデータ。データ収集の状況も示されます。
ファイル: confluence-traffic-distribution-[date].csv
このファイルには、ユーザーが実行したさまざまなアクションのトラフィックの配分率が含まれています。 アクションの一覧は次のとおりです。
- ページの表示時
- ページの編集時
- コメントの追加
- インライン コメントの追加と解決
- クイック検索の使用
- 高度な検索を使用する
- ページまたはコメントへのいいね
- ページの公開
- 下書きの作成
- ホーム ページの表示
- ページ履歴の表示
- ブログの表示
- ラベルを追加する
- グループのスペース権限の切り替え (有効化または無効化)
- CQL (Confluence クエリ言語) を利用したユーザー名検索
- CQL を利用したランダムなページ ID での検索
- CQL を利用したページ タイトル検索