HTTP Requests

The http collector can be used to execute http requests from inside the cluster. The response code and response body will be included in the collected data. The http collector can be specified multiple times in a collector spec.

Parameters

The http collector can be either of get, post or put.

In addition to the shared collector properties, it accepts the following parameters:

• url (Required)

  The URL to make the HTTP request against.

• insecureSkipVerify (Optional)

  When set to true, this will make connections to untrusted or self-signed certs. This defaults to false.

• headers (Optional)

  When present, additional headers to send with the request. By default, there are no headers added to the request.

• body (Optional)

  When present, the body to be send with the request. By default, there is no body included in a request. This parameter is not supported if the method is get.

• timeout (Optional)

  When present, the timeout for the request.

Example Collector Definition

GET

The get method will issue an HTTP or HTTPS request to the specified URL The body parameter is not supported in the get method.

apiVersion: troubleshoot.sh/v1beta2
kind: SupportBundle
metadata:
  name: sample
spec:
  collectors:
    - http:
        collectorName: healthz
        get:
          url: http://api:3000/healthz
          timeout: 5s

POST/PUT

The post and put methods will issue an HTTP or HTTPS POST or PUT request to the specified URL.

apiVersion: troubleshoot.sh/v1beta2
kind: SupportBundle
metadata:
  name: sample
spec:
  collectors:
    - http:
        collectorName: service-control
        post:
          url: https://api:3000/service-control
          insecureSkipVerify: true
          body: '{"disable-service": true}'
          headers:
            Content-Type: "application/json"

Included resources

Result of each collector will be stored in the root directory of the support bundle.

[collector-name].json

If the collectorName field is unset it will be named result.json.

Response received from the server will be stored in the "response" key of the resulting JSON file:

{
  "response": {
    "status": 200,
    "body": "{\"status\": \"healthy\"}",
    "headers": {
      "Connection": "keep-alive",
      "Date": "Fri, 19 Jul 2019 20:13:44 GMT",
      "Server": "nginx/1.8.1",
      "Strict-Transport-Security": "max-age=31536000; includeSubDomains"
    },
    "raw_json": {                                                                                                                                          
      "status": "healthy"                                                                                                                              
    } 
  }
}

If the body of the response is valid JSON, it will also be saved under the key named "raw_json".

In case a client side error occurs and no respose is received, the error text will be stored in the error key:

{
  "error": {
    "message": "Put : unsupported protocol scheme \"\""
  }
}

Resulting file will contain either response or error but never both.