メインコンテンツへスキップ

概要

Enterprise コンソール(console.gnip.com)は、契約済みの Enterprise API アクセスをお持ちの Enterprise データ顧客が利用できます。現在 Enterprise データ顧客でない場合でも、詳細はenterprise dataをご覧ください。
これは X の Enterprise コンソール ダッシュボードの概要です。ここで取り上げるセクションは、製品の詳細、利用状況、一般的なアカウント管理など、コンソール内の各領域に対応しています。ご自身のアカウントに関するご質問がある場合は、担当のアカウントマネージャーにお問い合わせいただくか、Enterprise 製品向け技術ドキュメントをご確認ください。 アカウントマネージャーとの Enterprise トライアルおよびオンボーディングの一環として、Enterprise 顧客には console.gnip.com へのログイン情報が付与されます。これは Enterprise 製品へのアクセス状況の確認と設定を行うためのユーザーインターフェースです。顧客管理者向けの初期アクセスは、Enterprise のオンボーディングプロセスの一部として X によって設定され、その後、管理者が追加のユーザーを招待できます。Enterprise コンソールでは、Enterprise 製品に関連する詳細の管理および参照が可能です。  次のビデオでは、console.gnip.com のダッシュボード各所の概要を紹介します。  免責事項: ビデオに示されている一部の機能(特定の stream のエンリッチメントや X 以外のデータソース製品など)は、現在はご利用いただけない場合があります。

Products tab

console.gnip.com のアカウントにログインすると、ダッシュボードの products タブが表示されます。このページには、アカウントで現在利用可能な Enterprise 製品の概要が示されます。 PowerTrack や Decahose など、ストリーミング配信を利用する製品については、このページに製品名、stream ラベル、現在のアクティブ接続数、(該当する場合)各 stream の現在アクティブなルール数、直近 24 時間に配信されたアクティビティ(例: Posts)の生の件数が一覧表示されます。 Search API など、REST 配信の製品については、このページに製品名、ラベル(“streams” としても表示)、これらの endpoint を通じて返された現在のアクティビティ(例: Posts)、および endpoint ごとの複数のリクエスト件数が一覧表示されます。 Usage API は、これらの data の多くをプログラム的に提供します。 各 stream の詳細は、名前または設定ボタンをクリックすると確認できます。

概要

メインダッシュボードでいずれかの stream をクリックすると、その stream の概要ページに移動します。 stream 配信プロダクトの場合、このページには次の内容が含まれます:
  1. 各 stream 接続経由で配信されるアクティビティ数のボリュームチャート
  2. 当該 stream で現在アクティブな接続の詳細(接続 id と IP アドレス)
  3. ご利用の stream における最近の接続・切断・ルール更新イベントのログ
チャートのスケールは右上のリンクで調整できます。個々の接続や切断の表示は、チャート直下の凡例で該当するキーをクリックして切り替えられます。

接続

Connections ページでは、stream 上で最近発生した接続イベントの詳細を確認できます。各接続の開始・終了時刻(UTC 24 時間表記)、接続継続時間、接続元サーバーの IP、参照用の一意の接続 ID、現在の接続ステータスが含まれます。ステータスは指定した接続における最新イベントに対応します。具体的には「Client Connected」または切断(切断の種類が併記)です。接続のデバッグの詳細は、disconnections explained ガイドをご覧ください。

API ヘルプ

API ヘルプページでは、必要に応じて、使用中の stream 向けの API endpoint の URL と、その stream の Rules API endpoint を確認できます。さらに、サンプルの curl コマンド、stream endpoint への接続手順、そして stream の Rules API endpoint からルールをプログラムで追加、delete、一覧取得する方法を案内します。

ルール

Rules タブは PowerTrack の stream で利用でき、ユーザーインターフェースからプレーンテキストのルールを手動で入力して手早く始められる簡便な方法を提供します。なお、このインターフェースで手動追加できるルールは最大 1000 個までで、初期テストのみに使用してください。運用環境では、Rules API を用いてプログラムからルールを管理することを推奨します。

設定

Settings タブでは、stream 内の data の出力形式を切り替えられます。複数の形式オプションが用意されています。形式を変更するには、各オプションのラジオボタンを選択してください。変更は stream に再接続すると有効になります。なお、この設定は次回のリクエストまたは接続から即時適用され、新しい形式によってはパーサーが動作しなくなる可能性があります。 ご注意: 可能な限り多くの data を取得するための推奨設定は「Leave data in the original format」です。この設定では、拡張されたネイティブ形式の data がこちらで返されます。Activity streams 形式についてはこちらをご参照ください。

Usage タブ

Usage タブでは、さまざまな期間にわたる stream の利用状況に関するインサイトを提供します。利用状況情報へプログラムでアクセスする方法については、Usage API を参照してください。

月次

Monthly Usage ページでは、製品ごとに分類された stream の利用状況が表示されます。たとえば、特定のデータソースに対するカバレッジ製品(例:PowerTrack、Historical PowerTrack、PowerTrack Replay)はまとめてグループ化され、個別のデータに加えて合算したロールアップ件数も提供されます。件数には、当月累計、月末見込み(今月これまでの利用状況と月内の残り時間に基づく)、および直近 2 か月分の件数が含まれます。 特に、これらの件数は製品および stream ごとに重複排除されています。同じ PowerTrack stream に複数の接続で同一の Post を受信した場合でも、その Post は本集計では 1 回としてカウントされます。件数は 24 時間ごとに 00:00 UTC に更新されます。

日次

Daily Usage ページでは、当月の各日における重複排除済みのカウントを製品別に表示します。カウントは毎日 00:00 UTC に更新されます。

ルール

ルールの上限は、契約済みの PowerTrack ルールパッケージに基づき、指定された「type」のすべてのstreamに適用されます。新しいルールが追加またはdeleteされるたびに、カウントが更新されます。

アカウント タブ

マイプロフィール

このページでは、ご自身のユーザープロフィールの詳細を確認し、パスワードを変更できます。加えて、アカウントごとの使用量しきい値通知を設定できます。API のステータス通知は、https://api.twitterstat.us のステータスページで確認できます。

アカウント設定

ユーザーの追加・削除・編集を行い、各ユーザー向けのメール通知や使用量のしきい値アラートを設定できます。
ユーザーには3種類があります — Account Admin、User、Email Only。  
  • Account Admin は他のユーザーの作成/delete/編集が可能で、username(メールアドレス)とパスワードを用いたベーシック認証で Enterprise の API に接続できます
  • User は他のユーザーの作成や変更はできませんが、username(メールアドレス)とパスワードを用いたベーシック認証で Enterprise の API に接続できます
  • Email Only ユーザーはダッシュボードにアクセスできず、Enterprise の API への接続も許可されていません。通知セクションで受信するよう設定されている場合にのみ通知を受け取ります。

使用量のしきい値

製品ごとのボリュームしきい値を設定します。これにより、プロフィールで該当の通知を有効にしているユーザーに対し、各製品の警告しきい値および重大しきい値に関するメールアラートが送信されます。
これらのしきい値は毎日 19:30(UTC)に一度評価され、リアルタイムでは評価されませんのでご注意ください。
I