Basic filtering

You can filter your app’s requests based on properties like request path, request method, response status code, and many more. These filters are expressed using the syntax of SQL WHERE clauses. Here’s an example of filtering requests that have a 5XX status code by using the filter http_resp_status_code LIKE '5%':

See here for the list of properties you can filter on with Subtrace out of the box.

Autocompletion

Notice that in the video above, we didn’t type out the entire name http_resp_status_code. We were able to type just a section of it, and use the ⇥ Tab key to autocomplete the name. This works similarly to shells like bash or zsh.

When we detect that an autocomplete suggestion is available, it will be displayed next to the current word being typed. If there are multiple available suggestions, you can choose among them using the and arrow keys.

Recognized properties

These are the properties that Subtrace recognizes for filters. But that doesn’t mean these are the only properties you can filter on. You can add some additional information to your request/response headers to allow you to filter on custom properties.

Basic information

  • hostname
  • http_duration
  • protocol
  • service

Request properties

  • http_client_addr
  • http_is_outgoing
  • http_req_body_size_bytes_wire
  • http_req_content_encoding
  • http_req_content_length
  • http_req_content_type
  • http_req_host
  • http_req_method
  • http_req_path
  • http_req_transfer_encoding
  • http_req_x_forwarded_for
  • http_server_addr
  • http_version
  • tls_server_name

Response properties

  • http_resp_body_size_bytes_wire
  • http_resp_content_encoding
  • http_resp_content_length
  • http_resp_content_type
  • http_resp_status_code
  • http_resp_transfer_encoding

Process information

  • process_command_line
  • process_executable_name
  • process_executable_size
  • process_id
  • process_user

Google Cloud specific information (if running on GCP)

  • gcp_project

Kubernetes specific information (if running on Kubernetes)

  • gke_cluster_location
  • gke_cluster_name
  • gke_node_name
  • kubernetes_namespace