【Domo】Box Analyticsの接続方法

はじめに

クラウドストレージとしてBOXを活用されている企業では、BOXの使用量や誰がどれだけアクセスしたか等のアクティビティログを可視化したいニーズがあるかと思います。
DomoにはBox Analyticsコネクターがあり、それらの情報を取得することが可能です。
<例 アクティブユーザ数やストレージ使用量>
 
 

解説

まず、「データ」タブから「データを接続」>「コネクタ」をクリックします。
次に「Box Analytics」で検索すると2つのコネクタが表示されます。
BOX AnalyticsコネクタとBOX Analytics Advancedコネクタの2つがありますが、
2つとも取得できるデータは同じになります。
Advancedコネクタはデータ取得時のフィルター設定が可能なので、日付範囲を指定してデータを取得したい場合などにご活用ください。
 
コネクタをクリックしてDataSet作成画面にうつります。
初めて接続する場合は、まず「接続」をクリックします。
(過去に接続したことがある場合はアカウントが表示されているはずなのでアカウントを選択して次にすすみましょう。)
 
「接続」をクリックすると新しいウィンドウでBOXの承認画面を開きます。
メールアドレスとパスワードを入力して「承認」ボタンをクリックします。
つぎにBOXへのアクセスを承認する画面が表示するので「BOXへのアクセスを許可」をクリックします。
クリックすると、Domoの画面に戻ります。
アカウントが追加されているはずなので、「次へ」をクリックします。
次に出力するレポートを選択する画面に遷移します。
出力できるレポートは4種類あります。
ファイルとフォルダレポート
ヘッダー内容
typeファイル化フォルダか
id
etag
sequence_id
can_non_owners_invite
content_created_at作成日時
content_modified_at編集日時
created_at
created_by_type
created_by_id
created_by_name作成ユーザ名
created_by_login
description
folder_upload_email
has_collaborations
is_externally_owned
item_status
modified_by_type
modified_by_id
modified_by_name編集ユーザ名
modified_by_login
nameファイルかフォルダ名
owned_by_type
owned_by_id
owned_by_name所有者
owned_by_login
parent_type
parent_id
parent_sequence_id
parent_etag
parent_name親ディレクトリ名
path_collection_total_count
permissions_can_download
permissions_can_upload
permissions_can_rename
permissions_can_delete
permissions_can_share
permissions_can_invite_collaborator
permissions_can_set_share_access
purged_at
shared_link
sizeファイルのデータ容量
sync_state
trashed_at
watermark_info_is_watermarked
allowed_invitee_roles_allowed_invitee_roles
allowed_shared_link_access_levels_allowed_shared_link_access_levels
path_collection_entries_type
path_collection_entries_id
path_collection_entries_sequence_id
path_collection_entries_etag
path_collection_entries_name
permissions_can_preview
permissions_can_comment
permissions_can_annotate
permissions_can_view_annotations_all
permissions_can_view_annotations_self
permissions_can_create_annotations
permissions_can_view_annotations
ユーザレポート
ヘッダー内容
typeuser
idユーザID (数値)
nameユーザ名
loginログインID
created_at作成日時
modified_at編集日時
language言語
timezoneタイムゾーン
space_amount使用容量上限
space_used使用中のデータ容量
max_upload_sizeアップロード容量上限
statusステータス
job_title役職
phone電話番号
address住所
avatar_urlアバターURL
notification_email
エンタープライズイベントレポート
対象の環境内のイベントログ
ヘッダー中身
source_type
source_id
source_name(ログインなどのイベントの場合)ユーザ名
source_login
created_by_type
created_by_id
created_by_nameイベントを発生させたユーザ名
created_by_login
action_by
created_atイベント発生時刻
event_id
event_typeイベントログの種類(ログイン, 閲覧, アップロード, ダウンロード等)
ip_address
type
session_id
additional_details
additional_details_service_id
additional_details_service_name
source_item_typeファイルかフォルダか
source_item_id
source_item_nameファイルやフォルダ名
source_parent_type
source_parent_name対象のファイルやフォルダが保存されているディレクトリ名
source_parent_id
source_owned_by_type
source_owned_by_id
source_owned_by_nameファイルなどの所有者
source_owned_by_login
additional_details_sizeファイルなどのデータ容量
additional_details_ekm_id
additional_details_access_token_identifier
additional_details_version_id
additional_details_shared_link_id
シングルユーザイベントレポート
接続したアカウントのイベントログ(ログインなどは含まれない)
ヘッダー内容
type
event_id
created_by_type
created_by_id
created_by_name対象のユーザ名
created_by_login
created_atイベント時刻
recorded_at
event_typeイベントログの種類( 閲覧, アップロード, ダウンロード等)
session_id
source_typeファイルかフォルダか
source_id
source_file_version_type
source_file_version_id
source_file_version_sha1
source_sequence_id
source_etag
source_sha1
source_nameファイルやフォルダ名
source_description
source_sizeファイルのデータ容量
source_path_collection_total_count
source_path_collection_entries
source_created_atファイル作成日時
source_modified_atファイル編集日時
source_trashed_atゴミ箱に移動した日時
source_purged_at消去した日時
source_content_created_at
source_content_modified_at
source_created_by_type
source_created_by_id
source_created_by_name作成ユーザ名
source_created_by_login
source_modified_by_type
source_modified_by_id
source_modified_by_name編集ユーザ名
source_modified_by_login
source_owned_by_type
source_owned_by_id
source_owned_by_name所有者
source_owned_by_login
source_shared_link
source_parent_type
source_parent_id
source_parent_sequence_id
source_parent_etag
source_parent_name対象のファイルやフォルダが保存されているディレクトリ名
source_item_status
source_synced
additional_details_original_item_type
additional_details_original_item_id
additional_details_original_item_name
source_folder_upload_email
Advancedコネクタでは、フォルダのID指定・出力するフィールドの選択・日付範囲の指定など詳細な設定が可能です。
出力するレポートやフィールドを選択したら「次へ」をクリックします。
以降は他のコネクタと同様にスケジュールの設定・DataSetの名前入力の画面を経て、DataSet作成完了です。
 

さいごに

BOXをお使いの方は使用量のモニタリングなどに活用できるので、ぜひ試してみてください。
📊
・会社のデータをもっと有効活用をしたい ・Domoに取り込みたいデータソースがある ・Domoの効果的な可視化についてもっと知りたい ・組織においてのDomoの定着化をもっと推進したい ・新しいKPIを作りたいが、自信がない アタラにはDomoを含むBIツールのエキスパートが在籍しております。 このような課題をお持ちの方は、ぜひお気軽にこちらまでご相談ください。
 
この記事をシェアする