Confluence Cloud Migration Assistant を利用してご利用のインスタンスの規模を評価する: データベース クエリと利用状況のメトリクス

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

You can assess the cloud readiness of your Confluence Data Center instance by collecting data about its content, such as the number of users, spaces, pages, attachments, and many more.

動作の仕組み

The cloud readiness of your Data Center instance will be assessed by comparing your data with Atlassian guardrails relevant for migrations or your future setup in cloud.

How you’ll collect, share, and view your data can be done in one of the following ways:


OPTION 1 Using Portfolio insights RECOMMENDED

You’ll use Portfolio insights to connect to Data Center and collect the data (with a fallback manual collection possible). Your cloud readiness report will be generated instantly.

Your raw data will be available to Atlassian migration teams who can provide additional information, if needed.





OPTION 2 Sharing raw data with Atlassian

You’ll run the assessment from the migration assistant and attach results to your MOVE ticket. Migration teams will prepare a cloud readiness report and share it with you.

Note: Use this option only when recommended by Atlassian migration teams.

収集されるデータ

In both options, the report is prepared based on the data collected through the migration assistant. Here’s a summary of what we collect:

  • Confluence entities: Number, or metadata, of entities, such as spaces or pages

  • Usage data: for example the number of active users in the past days

  • Instance metadata: products installed, details about the database, Data Center nodes, and some metadata related to your instance, such as Server ID or timezone

  • Browser metrics: performance and browser metrics, including network speed and quality, based on users' browser

Once collected, the data is saved in a ZIP archive and either transferred or uploaded to Portfolio insights or attached by you to your MOVE migration ticket.

For more details, see What data is collected

Not all collected data is analyzed and used in your report.

当社でのデータの利用について

We’ll only collect and use the metadata about your Confluence instance. This metadata doesn’t contain any Personally Identifiable Information (PII) or user-generated content (UGC). It’s based only on IDs.

これにより、当社ではお客様のデータの複雑さとクラウド製品におけるパフォーマンス要件をよりよく理解し、お客様のリスクを軽減して成功へと導く移行戦略や計画を立てることができます。さらに、収集されたメタデータは、当社の製品やツールを継続的に改善するのに役立ちます。

FAQ

Here are some common questions.

個人を特定できるデータを収集していますか?

The assessment doesn’t collect any personal identifiable data (PII). Any data that we collect is based on IDs.

Do I need Internet connection? Do you call APIs outside of my network?

The Internet connection is required for Option 1: Portfolio insights when you connect to your Data Center instance and automatically transfer the data to Portfolio insights.

If you have an air-gapped environment, you can fallback to manual collection and upload.

We’re also not calling any APIs outside of your instance’s network.

Do I need to run the assessment on the production instance or is the testing one enough?

 We recommend that you run the assessment on your production instance, because it improves accuracy of our recommendations. We understand that’s not always possible, so here’s a more detailed explanation so you can decide.

Data shape

When it comes to data shape, which is – for example – the number of spaces, users, configuration items, entities exceeding the guardrails, and so on, the testing instance should be sufficient. Even if it's behind the production instance by a month, the data shape will be relatively similar, so we'll be able to assess it accurately. The production instance is still better, but the testing one should be enough.

Performance: Traffic, usage, and instance metadata

Apart from just data, we also assess the traffic and usage of your instance, based on the data from your users' browsers. We also collect instance metadata, which is – for example – hardware details or network speed. All of these metrics can affect performance and we use it to determine whether your target cloud site is sufficient for your needs. If it’s not, we might recommend splitting your instance into multiple sites in cloud.

Assessing your testing instance won’t give accurate (or any) results on traffic, usage, and instance metadata, which are important factors.

Do I need to run the assessment on each Data Center node separately?

No, the assessment collects the data from the entire Data Center instance, and you don't need to run it separately on each node.

You also can't choose a specific node to run it on. 

What's the performance impact on the Data Center instance?

当社では、評価がインスタンスに影響しないようにするために、パフォーマンス テストや最適化を行っています。実行中もユーザーは Confluence で作業を続行できます。

What's the user key / ID collected from the user's browsers?

ユーザーのブラウザからデータを収集する際、各ユーザーに関連付けられているユーザー キーが収集されます。ユーザー キーはエクスポート時にハッシュ化され、アトラシアンのチームに公開されることはありません。これらは、研究と分析を目的としたグループ化、クラスタリング、およびテーマ作成にのみ使用されます。

はじめる前に

前提条件は次のとおりです。

  • We add new data points on a regular basis. To get the most accurate results, update Confluence Cloud Migration Assistant to the latest version.

  • The assessment duration depends on your data. On average it takes up to a few hours, but should be much faster for less complex instances.

OPTION 1

Using Portfolio insights RECOMMENDED

In this option, you’ll connect to your Data Center instance from Portfolio insights to collect the results, and then view your cloud readiness report.

1. Go to Portfolio insights

You can access Portfolio insights by going to admin.atlassian.com, and selecting Settings > Portfolio insights. Check the following page for detailed instructions.

ポートフォリオ インサイトの使用を開始する

2. Connect to your Data Center instance

To connect to a Data Center instance, you’ll need to meet some requirements like installing the Cloud Companion app and allowlisting the https://api.atlassian.com domain.

How to connect to Data Center instances

3. (Fallback) Manually collect and upload data

If you’re unable to connect to your Data Center instance, you can manually run the assessment and upload the results to Portfolio insights.

How to manually collect and upload data

4. View your cloud readiness report

Once the data is collected and transferred/uploaded to Portfolio insights, you’ll be able to view your cloud readiness report, with insights into your data and recommendations on how to fix or improve it.

How to view your cloud readiness report

OPTION 2

Sharing raw data with Atlassian

In this option, you’ll manually run the assessment from the migration assistant. When it’s ready, you’ll download a ZIP archive and share it with Atlassian by attaching it to your MOVE ticket.

1. 移行アシスタントから評価を実行する

1. 評価を有効化

If you updated your migration assistant to the latest version, the assessment will already be enabled so you can skip this step. We're leaving this flag for users on earlier versions.

評価を有効化するには、次の手順を実行します。

  1. <Confluence-url>/admin/darkfeatures.action に移動します。

  2. 次のフラグを追加します。 

    migration-assistant.enable.assess-l1-cloud-tooling.feature

For details, see Enabling dark features in Confluence.

2. Run the assessment in your migration assistant

評価を実行してデータを収集するには、次の手順を実行します。

  1. Confluence Cloud Migration Assistant を開きます。

  2. In the Assess your instance card on the home screen, select Begin assessing.

  3. We’ll ask you to confirm that the data will be stored on your instance. Select Continue.

  4. The assessment will start.

2. Download and share results with Atlassian

1. Download the ZIP archive

Once the assessment is complete, select Download report in the same Assess your instance card.

2. 結果をアトラシアンに共有

結果をアトラシアンに共有します。ほとんどの場合、このページを案内したされた MOVE チケットまたはサポート リクエストに添付することになります。

当社で出力結果を確認し、複雑さ、データの形、パフォーマンス要件、および存在している場合はリスクを把握します。これらは、お客様の移行戦略と計画の作成に役立ちます。

収集されるデータ

Details of files included in the ZIP archive and examples of collected data points. 

ファイル説明
confluence-entities-[date].csvデータベースから取得された、特定のエンティティに関するデータ。ご利用のインスタンスの規模を当社で理解し、最適な移行戦略を判断するのに役立ちます。
confluence-macros-[date].jsonl

Confluence マクロに関するデータ。これには以下の情報が含まれます。

  • クラウドには存在せず、したがって互換性がないマクロ
  • 同等のものがクラウドに存在するが、機能に多少の違いがあるマクロ
  • Nested-body macros that will be broken after migration

We don't collect data on all macros from your instance. We include specific types of macros not available in cloud or different from their cloud equivalents, and specific sequences of nested-body macros. For details, see the sections below.

When you send the assessment file to Atlassian, we won’t be able to analyze macros. We’re only sharing this data in the file to give you more info on the incompatible macros we found.


confluence-browser-metrics-[date].jsonlインスタンスのパフォーマンスに関する、ユーザーのブラウザから取得されたデータ。これは、クラウドで最高のパフォーマンスを実現するために必要な要素を当社で理解するのに役立ちます。
confluence-usage-metrics-[date].csvアクセス ログから取得された、使用状況のメトリクス。Confluence Cloud チームがお客様に最適なクラウド インスタンスを判断するのに役立ちます。
confluence-traffic-distribution-[date].csv

ページの閲覧やコメントの追加など、ユーザーが行ったさまざまなアクションによるトラフィックの分布 (%)。異常なトラフィックを見つけるのに役立ちます。

Details of metrics included in the files

More details about the data points and metrics included in the files.

ファイル: confluence-entities-[date].csv

The file includes data about Confluence entities, for example:

  • Spaces and pages
  • Users and groups
  • Attachments and media
  • データベーステーブル

You can find more details on exact metrics below.

What kind of entities are collected
  • ユーザーの総数

  • 一意のユーザー名を持つユーザーの数

  • アクティブなユーザー数

  • 非アクティブなユーザーの数

  • ユーザー グループの数

  • ステータスごとのスペースの総数

  • もっとも多くの添付ファイルを持つ上位 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 個の非個人スペースのメタデータ

  • もっとも大きなデータ サイズを持つ個人スペースのメタデータ

File: confluence-macros-[date].jsonl

The file includes information about macros that won't be fully compatible after the migration. It doesn't include all macros from your instance – we only collect specific types and sequences that we know are incompatible with cloud.

The macros in the file are divided into spaces where they appear, and include the following main types:

タイプ詳細
Different macros

Macros whose equivalents exist in cloud, but have some differences in functionality.

Collected macros: viewxls, viewppt, change-history, contentbylabel, code

Not available macros

Macros that don't exist in cloud and won't work after the migration.

Collected macros: html, html-include, rss

Nested macros

Macros that are nested inside other macros.

We collect a high number of sequences (for example, divbox > section > divbox > text-data) that we know aren't supported in cloud, but not all possible sequences. 

We don't support all macros or nested-body macros because collecting and analyzing every possible case could have performance impact on your instance and make the assessment package too large.

When you send the assessment file to Atlassian, we won’t be able to analyze macros. We’re only sharing this data in the file to give you more info on the incompatible macros we found, so you can review them.

File: 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 インスタンスに伝わり、戻ってくるまでにかかる時間の測定値です。これは、ユーザーのネットワーク接続の応答性を測定するのに役立ちます。

File: 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 を利用したページ タイトル検索
最終更新日 2025 年 6 月 26 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.