Merge pull request #1258 from dmitryblackwell/microservices-timeout-page

docs(microservices) add microservices-timeout page

Author: kamilmysliwiec

content/microservices/basics.md

@@ -348,3 +348,27 @@ export interface RequestContext<T = any> {
 ```
 
 The `data` property is the message payload sent by the message producer. The `pattern` property is the pattern used to identify an appropriate handler to handle the incoming message.
+
+
+### Handling timeouts
+
+In distributed systems, sometimes microservices might be down or not available. To avoid infinitely long waiting, you can use Timeouts. A timeout is an incredibly useful pattern when communicating with other services. To apply timeouts to your microservice calls, you can use the `RxJS` timeout operator. If the microservice does not respond to the request within a certain time, an exception is thrown, which can be caught and handled appropriately.
+
+To solve this problem you have to use [rxjs](https://github.com/ReactiveX/rxjs) package. Just use the `timeout` operator in the pipe:
+
+```typescript
+@@filename()
+this.client
+      .send<TResult, TInput>(pattern, data)
+      .pipe(timeout(5000))
+      .toPromise();
+@@switch
+this.client
+      .send(pattern, data)
+      .pipe(timeout(5000))
+      .toPromise();
+```
+
+> info **Hint** The `timeout` operator is imported from the `rxjs/operators` package.
+
+After 5 seconds, if the microservice isn't responding, it will throw an error.