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

概要

エンタープライズコンソール(console.gnip.com)は、契約に基づきエンタープライズ API へのアクセス権を有するエンタープライズ向けデータ顧客が利用できます。現在エンタープライズ向けデータ顧客でない場合でも、詳細はエンタープライズデータをご覧ください。
これは X のエンタープライズコンソール・ダッシュボードの概要です。以下のセクションでは、プロダクトの詳細、利用状況、一般的なアカウント管理など、コンソール内の各領域について説明します。お客さまのアカウントに関するご質問は、担当アカウントマネージャーまでお問い合わせいただくか、エンタープライズ製品の技術ドキュメントをご確認ください。 アカウントマネージャーとのエンタープライズのトライアルおよびオンボーディングの一環として、エンタープライズ顧客にはconsole.gnip.comへのログイン資格情報が付与されます。ここは、エンタープライズ製品へのアクセスを確認・設定できるユーザーインターフェースです。コンソールへの初回の管理者アクセスはオンボーディングの一部として X により設定され、その後管理者が追加ユーザーを招待できます。エンタープライズコンソールでは、エンタープライズ製品に関する詳細の管理と参照が可能です。  次の動画では、console.gnip.com のダッシュボード各部の概要をご紹介します。  免責事項: 動画で紹介している一部の機能(特定のストリーム拡張や X 以外のデータソース製品など)は、現在ご利用いただけない場合があります。

製品タブ

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

概要

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

接続

Connections ページでは、ストリームで最近発生した接続イベントの詳細を表示します。内容には、各接続の開始時刻・終了時刻(UTC、24時間表記)、接続の継続時間、接続元サーバーの IP、参照用の一意の接続 ID、現在の接続ステータスが含まれます。ステータスは指定した接続における最新イベントを示し、たとえば「Client Connected」や切断(切断タイプを含む)などが該当します。接続のデバッグの詳細は、disconnections explained ガイドをご覧ください。

APIヘルプ

APIヘルプページには、ストリーム用のAPIエンドポイントURLに加え、該当する場合はストリームのRules APIエンドポイントも記載されています。さらに、サンプルのcurlコマンド、ストリームエンドポイントへの接続手順、そしてプログラムでストリームのRules APIエンドポイントからルールを追加・削除・一覧取得する方法が含まれています。

ルール

Rules タブは PowerTrack ストリームで利用でき、ユーザーインターフェースからプレーンテキストのルールを手動入力して素早く開始できます。なお、このインターフェースでの手動追加は最大 1000 件までに限られるため、初期テストのみに使用してください。本番環境では、Rules API を通じてプログラムでルールを管理することを推奨します。

設定

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

Usage タブ

Usage タブでは、さまざまな期間におけるストリームの利用状況を確認できます。プログラムから利用状況にアクセスする方法については、Usage APIを参照してください。

月次

Monthly Usage ページでは、製品別に分解されたストリームの使用量が表示されます。たとえば、特定のデータソースに対するカバレッジ系の製品(例: PowerTrack、Historical PowerTrack、PowerTrack Replay)はグループ化され、個別のデータに加えて合算のロールアップカウントが提供されます。カウントには、当月累計、月末時点の推定値(今月これまでの使用量と月末までの残り期間に基づく)、および直近2か月分のカウントが含まれます。 なお、これらのカウントは製品およびストリームごとに重複排除されています。同じ PowerTrack ストリームへの複数の接続を通じて同一の Post を受信した場合でも、この目的においてその Post は1回としてカウントされます。カウントは毎日 00:00 UTC に更新されます。

日次

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

ルール

ルールの上限は、契約中の PowerTrack ルールパッケージに基づいて、同一の「タイプ」に属するすべてのストリームに適用されます。カウントは、新しいルールを追加または削除するたびに更新されます。

アカウント タブ

マイプロフィール

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

アカウント設定

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

使用量のしきい値

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