Skip to content

Commit abe48bd

Browse files
committed
routing
1 parent 496aa93 commit abe48bd

File tree

3 files changed

+17
-42
lines changed

3 files changed

+17
-42
lines changed

deploy-manage/maintenance/ece/start-stop-routing-requests.md

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,33 +5,43 @@ mapped_urls:
55
applies_to:
66
deployment:
77
ece:
8+
ess:
89
---
910

1011
# Start and stop routing requests [maintenance-mode-routing]
1112

12-
The {{ecloud}} proxy service routes traffic from external sources to the deployment, between deployments, and between products within a deployment. For example, it routes API requests from your local machine to your deployment, CCR and CCS requests between your deployments, and communications between {{kib}} and {{es}}. It does not direct the TCP traffic between {{es}} nodes, nor does it manage requests starting within {{es}} outwards to external sources such as to snapshot repositories.
13+
The cloud proxy service routes traffic from external sources to the deployment, between deployments, and between products within a deployment. For example, it routes API requests from your local machine to your deployment, CCR and CCS requests between your deployments, and communications between {{kib}} and {{es}}. It does not direct the TCP traffic between {{es}} nodes, nor does it manage requests starting within {{es}} outwards to external sources such as to snapshot repositories.
1314

14-
The {{ecloud}} proxy routes HTTP requests to its deployment’s individual product instances through the product’s endpoint. By default, instances are enabled to route HTTP traffic and will report no special messaging.
15+
The cloud proxy routes HTTP requests to its deployment’s individual product instances through the product’s endpoint. By default, instances are enabled to route HTTP traffic and will report no special messaging.
1516

1617
It might be helpful to temporarily block upstream requests in order to protect some or all instances or products within your deployment. For example, you might stop request routing in the following cases:
1718

1819
* If another team within your company starts streaming new data into your production {{integrations-server}} without previous load testing, both it and {{es}} might experience performance issues. You might consider stopping routing requests on all {{integrations-server}} instances in order to protect your downstream {{es}} instance.
19-
* If {{es}} is being overwhelmed by upstream requests, it might experience increased response times or even become unresponsive. This might impact your ability to resize components in your deployment and increase the duration of pending plans or increase the chance of plan changes failing. Because every {{es}} node is an [implicit coordinating node](elasticsearch://reference/elasticsearch/configuration-reference/node-settings.md), you should stop routing requests across all {{es}} nodes to completely block upstream traffic.
20+
* If {{es}} is being overwhelmed by upstream requests, it might experience increased response times or even become unresponsive. This might impact your ability to resize components in your deployment and increase the duration of pending plans or increase the chance of plan changes failing. Because every {{es}} node is an [implicit coordinating node](/deploy-manage/distributed-architecture/clusters-nodes-shards/node-roles.md#set-node-roles), you should stop routing requests across all {{es}} nodes to completely block upstream traffic.
2021

2122
## Considerations [request-routing-considerations]
2223

23-
* {{ecloud}} will automatically set and remove routing blocks during plan changes. Elastic recommends avoiding manually overriding these settings for a deployment while its plans are pending.
24-
* The [{{es}} API console](../../../explore-analyze/query-filter/tools/console.md) bypasses {{ecloud}} proxy routing blocks against {{es}} to enable administrative tasks while plan changes are pending. You should generally default traffic to the {{es}} endpoint. However, if you enable **Stop routing requests** across all {{es}} nodes, you need to use this UI to administer your cluster.
24+
* ECE and ECH will automatically set and remove routing blocks during plan changes. Elastic recommends avoiding manually overriding these settings for a deployment while its plans are pending.
25+
* The [{{es}} API console](/explore-analyze/query-filter/tools/console.md) bypasses cloud proxy routing blocks against {{es}} to enable administrative tasks while plan changes are pending. You should generally default traffic to the {{es}} endpoint. However, if you enable **Stop routing requests** across all {{es}} nodes, you need to use this UI to administer your cluster.
2526
* While {{es}} has **Stop routing requests** set across all nodes, other products with the deployment may become unhealthy. This is because {{es}} is a prerequisite for those other products, such as {{kib}}. In {{kib}}, this results in a [**Kibana server is not ready yet**](../../../troubleshoot/kibana/error-server-not-ready.md) message.
26-
* Enabling **Stop routing requests** does not affect your [billing](../../../deploy-manage/cloud-organization/billing.md). If needed, you can stop charges for a deployment by [deleting the deployment](../../../deploy-manage/uninstall/delete-a-cloud-deployment.md).
27+
* In {{ech}}, enabling **Stop routing requests** does not affect your [billing](../../../deploy-manage/cloud-organization/billing.md). If needed, you can stop charges for a deployment by [deleting the deployment](../../../deploy-manage/uninstall/delete-a-cloud-deployment.md).
2728

2829
## Stop routing requests [stop-routing-requests]
2930

3031
To block HTTP requests for an instance, select **Stop routing requests** under from instance’s menu.
3132

3233
The instance will then report **Not routing requests**. It will complete existing requested traffic, but not be sent new requests.
3334

34-
You can stop routing requests to disable incoming requests to particular instances. You can also massively disable all allocator instances routing with the [allocator-toggle-routing-requests.sh](https://download.elastic.co/cloud/allocator-toggle-routing-requests.sh) script. The script runs with the following parameters in the form environment variables:
35+
## Restart routing requests [restart-routing-requests]
36+
37+
To unblock HTTP requests for an instance, select **Start routing requests** under from instance’s menu.
38+
39+
## Toggle routing to all instances on an allocator
40+
```{applies_to}
41+
deployment:
42+
ece:
43+
```
44+
In {{ece}}, in addition to stopping routing requests for particular instances, you can also massively disable routing to all instances on a specified allocator with the [allocator-toggle-routing-requests.sh](https://download.elastic.co/cloud/allocator-toggle-routing-requests.sh) script. The script runs with the following parameters in the form environment variables:
3545

3646
* `API_URL` Url of the administration API.
3747
* `AUTH_HEADER` Curl format string representing the authentication header.
@@ -49,7 +59,3 @@ The same script can be used to enable traffic again:
4959
```bash
5060
AUTH_HEADER="Authorization: ApiKey $(cat ~/api.key)" API_URL="https://adminconsole:12443" ALLOCATOR_ID="192.168.44.10" ENABLE_TRAFFIC=true ./allocator-toggle-routing-requests.sh
5161
```
52-
53-
## Restart routing requests [restart-routing-requests]
54-
55-
To unblock HTTP requests for an instance, select **Start routing requests** under from instance’s menu.

raw-migrated-files/cloud/cloud/ec-maintenance-mode-routing.md

Lines changed: 0 additions & 30 deletions
This file was deleted.

raw-migrated-files/toc.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ toc:
2323
- file: cloud/cloud/index.md
2424
children:
2525
- file: cloud/cloud/ec-faq-technical.md
26-
- file: cloud/cloud/ec-maintenance-mode-routing.md
2726
- file: cloud/cloud/ec-monitoring-setup.md
2827
- file: cloud/cloud/ec-planning.md
2928
- file: cloud/cloud/ec-security.md

0 commit comments

Comments
 (0)