### MetricsHub
MetricsHub 1.0.00

Home
- Troubleshooting
Protocol CLIs 10

# HTTP CLI Documentation

The MetricsHub HTTP CLI is a powerful command-line utility for interacting with monitored resources. It supports common HTTP methods (`GET`, `POST`, `PUT`, and `DELETE`) to validate configurations, troubleshoot connectivity issues, and perform HTTP-based operations directly from the command line. The CLI supports authentication, custom headers, and request body configurations.

Before using the CLI, ensure your platform supports HTTP monitoring by checking the Connector Directory[1].

## Syntax

    httpcli --method <GET|POST|PUT|DELETE> --url <URL> --username <USERNAME> --password <PASSWORD> [--body <BODY> | --body-file <FILE PATH>] [--header <HEADER> | --header-file <FILE PATH>] --timeout <TIMEOUT>

## Options

Option | Description | Default Value
--- | --- | ---
`--url` | The URL for the HTTP request. | None
`--method` | the HTTP method to use for the request. Possible values: `GET`, `POST`, `PUT`, `DELETE`. | `GET`
`--header` | Custom headers for the request. Can be specified multiple times. | None
`--header-file` | Path to a file containing headers for the request. | None
`--body` | Request body as a string. | None
`--body-file` | Path to a file containing the request body. | None
`--username` | Username for HTTP authentication. | None
`--password` | Password for HTTP authentication. If not provided, you will be prompted interactively. | None
`--timeout` | Timeout in seconds for the HTTP operation. | 120
`-v` | Enables verbose mode. Use `-v` for basic logs, `-vv` for detailed logs. | None
`-h, --help` | Displays detailed help information about available options. | None

## Examples

### Example 1: HTTP GET Request with Headers and Body

    httpcli --method get --url https://dev-01:443/users --username username --password password --header="Content-Type:application/xml" --header="Accept:application/json" --body="<aaaLogin inName='username' inPassword='password' />" --timeout 120

### Example 2: HTTP POST Request with Header and Body Files

    httpcli --method post --url https://dev-01:443/users --username admin --password pass --header-file="/opt/metricshub/header.txt" --body-file="/opt/metricshub/body.txt" --timeout 120

### Example 3: HTTP Get Request with Interactive Password Input

    httpcli --method get --url https://example.com --username user

The CLI prompts for a password if not provided.

http cli monitoring observability opentelemetry otel
Links:

- [1] https://metricshub.com/docs/latest/metricshub-connectors-directory.html

## Search Results for {{siteSearch | truncate:'50'}}

{{resultArray.length}}
{{parent.title}} {{parent.title}}

{{result.title}}

{{result.body | truncate:'400'}}

{{parent.title}}
{{result.title}}
{{result.body | truncate:'100'}}

No results.