Cloud Bigtable Admin API . projects . instances . clusters . hotTablets

Instance Methods

close()

Close httplib2 connections.

list(parent, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)

Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.

list_next()

Retrieves the next page of results.

Method Details

close()
Close httplib2 connections.
list(parent, endTime=None, pageSize=None, pageToken=None, startTime=None, x__xgafv=None)
Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.

Args:
  parent: string, Required. The cluster name to list hot tablets. Value is in the following form: `projects/{project}/instances/{instance}/clusters/{cluster}`. (required)
  endTime: string, The end time to list hot tablets.
  pageSize: integer, Maximum number of results per page. A page_size that is empty or zero lets the server choose the number of items to return. A page_size which is strictly positive will return at most that many items. A negative page_size will cause an error. Following the first request, subsequent paginated calls do not need a page_size field. If a page_size is set in subsequent calls, it must match the page_size given in the first request.
  pageToken: string, The value of `next_page_token` returned by a previous call.
  startTime: string, The start time to list hot tablets. The hot tablets in the response will have start times between the requested start time and end time. Start time defaults to Now if it is unset, and end time defaults to Now - 24 hours if it is unset. The start time should be less than the end time, and the maximum allowed time range between start time and end time is 48 hours. Start time and end time should have values between Now and Now - 14 days.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for BigtableInstanceAdmin.ListHotTablets.
  "hotTablets": [ # List of hot tablets in the tables of the requested cluster that fall within the requested time range. Hot tablets are ordered by node cpu usage percent. If there are multiple hot tablets that correspond to the same tablet within a 15-minute interval, only the hot tablet with the highest node cpu usage will be included in the response.
    { # A tablet is a defined by a start and end key and is explained in https://cloud.google.com/bigtable/docs/overview#architecture and https://cloud.google.com/bigtable/docs/performance#optimization. A Hot tablet is a tablet that exhibits high average cpu usage during the time interval from start time to end time.
      "endKey": "A String", # Tablet End Key (inclusive).
      "endTime": "A String", # Output only. The end time of the hot tablet.
      "name": "A String", # The unique name of the hot tablet. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/hotTablets/[a-zA-Z0-9_-]*`.
      "nodeCpuUsagePercent": 3.14, # Output only. The average CPU usage spent by a node on this tablet over the start_time to end_time time range. The percentage is the amount of CPU used by the node to serve the tablet, from 0% (tablet was not interacted with) to 100% (the node spent all cycles serving the hot tablet).
      "startKey": "A String", # Tablet Start Key (inclusive).
      "startTime": "A String", # Output only. The start time of the hot tablet.
      "tableName": "A String", # Name of the table that contains the tablet. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`.
    },
  ],
  "nextPageToken": "A String", # Set if not all hot tablets could be returned in a single response. Pass this value to `page_token` in another request to get the next page of results.
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.