메인 콘텐츠로 건너뛰기

개요

enterprise 콘솔(console.gnip.com)은 계약된 enterprise API 액세스 권한을 보유한 엔터프라이즈 데이터 고객에게 제공됩니다. 현재 엔터프라이즈 데이터 고객이 아니지만 더 자세한 정보를 원하시면, enterprise 데이터에 대해 여기에서 확인할 수 있습니다.
이 문서는 X의 enterprise 콘솔 대시보드에 대한 개요입니다. 여기에서 다루는 섹션들은 제품 세부 정보, 사용량, 일반 계정 관리 등 콘솔의 각 개별 영역에 해당합니다. 특정 계정과 관련된 질문이 있는 경우, 지정된 계정 관리자에게 문의하시거나 enterprise 제품에 대한 기술 문서를 검토해 주세요. 계정 관리자와 함께 진행되는 enterprise 트라이얼 및 온보딩 과정의 일환으로, 엔터프라이즈 고객은 console.gnip.com에 로그인할 수 있는 계정을 부여받게 되며, 이곳은 enterprise 제품 액세스를 검토하고 구성할 수 있는 사용자 인터페이스입니다. 콘솔에 대한 최초 고객 관리자(admin) 액세스는 enterprise 온보딩 과정의 일부로 X에서 설정하며, 그 이후 관리자는 추가 사용자를 등록할 수 있습니다. enterprise 콘솔을 통해 enterprise 제품과 관련된 보다 자세한 정보를 관리하고 액세스할 수 있습니다.  아래 동영상에서는 console.gnip.com 대시보드의 다양한 영역에 대한 개요를 제공합니다.  면책조항: 동영상에 표시된 일부 기능(특정 스트림 enrichment 및 비 X 데이터 소스 제품 포함)은 더 이상 제공되지 않을 수 있습니다.

Products 탭

console.gnip.com에 계정으로 로그인하면 대시보드의 Products 탭이 처음 표시됩니다. 이 페이지에는 계정에서 현재 사용 가능한 엔터프라이즈 제품에 대한 개요가 포함되어 있습니다. PowerTrack 또는 Decahose와 같은 스트리밍 방식 전달을 사용하는 제품의 경우, 이 페이지에는 제품 이름, 스트림 레이블, 현재 활성 연결 수, 각 스트림에 대해 현재 활성화된 규칙 수(해당되는 경우), 그리고 최근 24시간 동안 전달된 활동의 원시 개수(예: 포스트)가 표시됩니다. Search API와 같은 REST 방식 전달 제품의 경우, 이 페이지에는 제품 이름, 레이블(“streams”로도 표시됨), 이러한 엔드포인트를 통해 반환된 현재 활동(예: 포스트), 그리고 엔드포인트별 여러 종류의 요청 횟수가 표시됩니다. Usage API는 이러한 데이터 대부분을 프로그래밍 방식으로 제공합니다. 각 스트림별 세부 정보는 이름 또는 설정 버튼을 클릭하면 확인할 수 있습니다.

개요

메인 대시보드에서 스트림 중 하나를 클릭하면 해당 스트림의 개요 페이지로 이동합니다. 스트리밍 전송 제품의 경우, 이 페이지에는 다음 항목이 포함됩니다.
  1. 각 개별 스트림 연결을 통해 전달되는 activity 수를 보여주는 볼륨 차트 
  2. 스트림에서 현재 활성 상태인 연결에 대한 세부 정보(연결 ID 및 IP 주소) 
  3. 스트림에 대한 최근 연결, 연결 종료, 규칙 업데이트 이벤트 로그
차트의 스케일은 오른쪽 상단의 링크로 조정할 수 있습니다. 개별 연결 및 연결 종료의 표시 여부는 차트 바로 아래 범례에서 해당 항목을 클릭하여 토글할 수 있습니다.

Connections

Connections 페이지에서는 스트림에서 발생한 최근 연결 이벤트에 대한 세부 정보를 제공합니다. 여기에는 각 연결의 시작 및 종료 시각(UTC 기준 24시간제), 각 연결의 지속 시간, 연결을 생성한 서버의 IP, 참조용 고유 연결 ID, 그리고 현재 연결 상태가 포함됩니다. 상태 값은 지정된 연결에 대해 발생한 가장 최근 이벤트를 나타내며, 예를 들어 Client Connected 이거나, 연결 해제 이벤트(해제 type 명시 포함)일 수 있습니다. 연결 디버깅에 대한 자세한 내용은 disconnections explained guide를 참조하세요.

API 도움말

API 도움말 페이지에서는 스트림에 대한 API 엔드포인트 URL과, 해당되는 경우 스트림의 Rules API 엔드포인트를 제공합니다. 또한 예시 curl 명령어와 스트림 엔드포인트에 연결하는 방법, 그리고 스트림의 Rules API 엔드포인트를 통해 규칙을 프로그래밍 방식으로 추가, 삭제 및 목록을 조회하는 방법에 대한 안내를 포함합니다.

Rules

Rules 탭은 PowerTrack 스트림에서 사용할 수 있으며, 사용자 인터페이스를 통해 일반 텍스트 기반 규칙을 수동으로 입력하여 빠르게 시작할 수 있는 방법을 제공합니다. 이 인터페이스에서는 이 수동 방식으로 최대 1,000개의 규칙만 추가할 수 있으며, 초기 테스트 용도로만 사용해야 합니다. 운영 환경에서는 Rules API를 통해 규칙을 프로그래밍 방식으로 관리할 것을 권장합니다.

Settings

Settings 탭에서는 스트림 데이터의 출력 형식을 변경할 수 있으며, 여러 가지 형식 옵션이 지원됩니다. 형식을 변경하려면 서로 다른 옵션을 나타내는 라디오 버튼을 사용하면 됩니다. 변경 사항은 스트림에 다시 연결할 때 적용됩니다. 이 설정을 변경하면 다음 요청 또는 연결부터 즉시 적용되며, 새 형식으로 인해 기존 파서가 동작하지 않을 수 있습니다.  주의: 가능한 한 많은 데이터를 수신하기 위한 권장 설정은 “Leave data in the original format”이며, 이는 여기에 설명된 대로 데이터가 보강된 네이티브 형식으로 반환되도록 합니다. Activity streams 형식은 여기에 설명되어 있습니다.

사용량 탭

사용량 탭에서는 다양한 기간별 스트림 사용량에 대한 인사이트를 제공합니다. 사용량 정보를 프로그래밍 방식으로 조회하려면 Usage API를 참조하세요.

월간

월간 사용량(Usage) 페이지에서는 스트림 사용량을 제품별로 구분하여 표시합니다. 예를 들어, 특정 데이터 소스에 대한 coverage 제품(예: PowerTrack, Historical PowerTrack, PowerTrack Replay 등)은 개별 데이터와 함께 통합 롤업 카운트를 제공하기 위해 하나로 묶여 표시됩니다. 카운트에는 이번 달 현재까지의 누적 사용량, 이번 달 남은 기간과 현재까지의 사용량을 기반으로 한 월말 예상 사용량, 그리고 직전 두 달의 카운트가 포함됩니다. 특히, 이러한 카운트는 제품 및 스트림 단위로 중복이 제거되어 집계됩니다. 동일한 PowerTrack 스트림에 여러 연결을 통해 동일한 게시물을 받은 경우, 이 목적상 해당 게시물은 한 번만 카운트됩니다. 카운트는 매일 UTC 기준 00:00에 업데이트됩니다.

일별

Daily Usage 페이지는 현재 달의 각 날짜에 대해 제품별로 구분된 일별 중복 제거 집계값을 제공합니다. 집계값은 매일 UTC 기준 00:00에 업데이트됩니다.

규칙

규칙 수 한도는 계약된 PowerTrack 규칙 패키지를 기준으로 하며, 특정 “type”에 속한 모든 스트림에 적용됩니다. 새 규칙이 추가되거나 삭제될 때마다 카운트가 업데이트됩니다.

계정 탭

내 프로필

개별 사용자 프로필에 대한 세부 정보를 확인하고 이곳에서 비밀번호를 변경할 수 있습니다. 또한 해당 계정에만 적용되는 계정 사용량 임계값 알림을 설정할 수 있습니다. API 상태 알림은 https://api.twitterstat.us의 상태 페이지에서 확인할 수 있습니다.

계정 설정

사용자를 추가, 제거 및 수정하고, 개별 사용자와 사용량 임계값 알림에 대한 이메일 알림을 구성할 수 있습니다.
사용자 유형은 Account Admin, User, Email Only의 세 가지입니다.  
  • Account Admin은 다른 사용자를 생성/삭제/수정할 수 있으며, 엔터프라이즈 API에 연결하기 위해 사용자 이름(이메일)과 비밀번호를 사용하는 기본 인증(basic authentication)을 사용할 수 있습니다.
  • User는 다른 사용자를 생성하거나 수정할 수 없지만, 엔터프라이즈 API에 연결하기 위해 사용자 이름(이메일)과 비밀번호를 사용하는 기본 인증(basic authentication)을 사용할 수 있습니다.
  • Email Only 사용자는 대시보드에 접속할 수 없으며, 엔터프라이즈 API에 연결할 권한이 없고, 알림(Notifications) 섹션에서 수신하도록 구성된 경우에만 알림을 받습니다.

사용량 임계값

제품별 사용량 임계값을 설정합니다. 각 제품의 경고 임계값과 중요 임계값에 대해, 프로필에서 해당 알림을 설정한 사용자에게 이메일 알림이 전송되도록 합니다.
이 임계값은 하루에 한 번 UTC 기준 19:30에만 평가되며, 실시간으로는 평가되지 않습니다.