---
title: "gRPC | Grafana k6 documentation"
description: "xk6-disruptor: gRPC Fault attributes"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# gRPC

A gRPC Fault describes the characteristics of the faults to be injected in the gRPC requests served by a target.

A gRPC fault is described by the following attributes:

Expand table

| Attribute      | Type   | Description                                                                                                    |
|----------------|--------|----------------------------------------------------------------------------------------------------------------|
| averageDelay   | string | average delay added to requests represented as a string (default `0`)                                          |
| delayVariation | string | variation in the injected delay (default `0`)                                                                  |
| statusMessage  | string | message to be returned when an error is injected                                                               |
| statusCode     | number | status to be returned when an error is injected                                                                |
| errorRate      | number | rate of requests that will return an error, represented as a float in the range `0.0` to `1.0` (default `0.0`) |
| exclude        | string | comma-separated list of services to be excluded from disruption                                                |
| port           | number | port on which the requests will be intercepted                                                                 |

> Note
> 
> `averageDelay` and `delayVariation` are applied to all requests affected by the fault, regardless of the value of `errorRate`. `statusCode` is returned only to a fraction of requests defined by `errorRate`.

## Example

This example defines a gRPC fault that introduces a delay of `50ms` in all requests and returns a status code `13` in `10%` of the requests.

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
const fault = {
  averageDelay: '50ms',
  statusCode: 10,
  errorRate: 0.1,
};
```