Update docs

Author: rtkkroland

README.md

@@ -67,6 +67,7 @@ elasticsearch_exporter --help
 | collector.health-report | 1.10.0                 | If true, query the health report (requires elasticsearch 8.7.0 or later)                                                                                                                                                                                                                                                                                                              | false |
 | es.slm                  |                       | If true, query stats for SLM.                                                                                                                                                                                                                                                                                                                                                         | false |
 | es.data_stream          |                       | If true, query state for Data Steams.                                                                                                                                                                                                                                                                                                                                                 | false |
+| es.remote_info          | 2.x.x                 | If true, query stats for configured remote clusters in the Elasticsearch cluster. Exposes connection metrics for cross-cluster search and replication.                                                                                                                                                                                                                                | false |
 | es.timeout              | 1.0.2                 | Timeout for trying to get stats from Elasticsearch. (ex: 20s)                                                                                                                                                                                                                                                                                                                         | 5s |
 | es.ca                   | 1.0.2                 | Path to PEM file that contains trusted Certificate Authorities for the Elasticsearch connection.                                                                                                                                                                                                                                                                                      | |
 | es.client-private-key   | 1.0.2                 | Path to PEM file that contains the private key for client auth when connecting to Elasticsearch.                                                                                                                                                                                                                                                                                      | |
@@ -107,6 +108,7 @@ es.shards | not sure if `indices` or `cluster` `monitor` or both |
 collector.snapshots | `cluster:admin/snapshot/status` and `cluster:admin/repository/get` | [ES Forum Post](https://discuss.elastic.co/t/permissions-for-backup-user-with-x-pack/88057)
 es.slm | `manage_slm`
 es.data_stream | `monitor` or `manage` (per index or `*`) |
+es.remote_info | `cluster` `monitor` | Required for accessing remote cluster connection information via the `/_remote/info` endpoint
 
 Further Information
 
@@ -175,6 +177,49 @@ Notes:
 - Any `options:` under an auth module will be appended as URL query parameters to the target URL.
 - The `tls` auth module (client certificate authentication) is intended for self‑managed Elasticsearch/OpenSearch deployments. Amazon OpenSearch Service typically authenticates at the domain edge with IAM/SigV4 and does not support client certificate authentication; use the `aws` auth module instead when scraping Amazon OpenSearch Service domains.
 
+### Remote Cluster Monitoring
+
+The remote info collector (`es.remote_info`) provides monitoring capabilities for Elasticsearch cross-cluster search and cross-cluster replication configurations. This collector queries the `/_remote/info` endpoint to gather connection statistics for configured remote clusters.
+
+#### When to Enable
+
+Enable this collector when you have:
+- Cross-cluster search configured
+- Cross-cluster replication set up
+- Multiple Elasticsearch clusters connected via remote cluster connections
+- Need to monitor the health and connectivity of remote cluster connections
+
+#### Metrics Provided
+
+The collector provides connection metrics labeled by `remote_cluster` name, including:
+- Active node connections to remote clusters
+- Proxy socket connections (for clusters behind proxies)
+- Maximum connection limits per cluster
+- Connection health and scrape statistics
+
+#### Prerequisites
+
+- Remote clusters must be properly configured in your Elasticsearch cluster
+- The user account must have `cluster:monitor` privileges to access the `/_remote/info` endpoint
+- Remote clusters should be accessible and properly configured with seeds
+
+#### Example Configuration
+
+To enable remote cluster monitoring:
+
+```bash
+./elasticsearch_exporter --es.uri=http://localhost:9200 --es.remote_info
+```
+
+The collector will automatically discover all configured remote clusters and expose metrics for each one.
+
+The remote info collector can also be enabled via the `ES_REMOTE_INFO` environment variable:
+
+```bash
+export ES_REMOTE_INFO=true
+./elasticsearch_exporter --es.uri=http://localhost:9200
+```
+
 ### Metrics
 
 | Name                                                                 | Type       | Cardinality | Help                                                                                                |
@@ -362,6 +407,12 @@ Notes:
 | elasticsearch_health_report_total_repositories                       | gauge      | 1           | The number snapshot repositories                                                                    |
 | elasticsearch_health_report_unassigned_primaries                     | gauge      | 1           | The number of unassigned primary shards                                                             |
 | elasticsearch_health_report_unassigned_replicas                      | gauge      | 1           | The number of unassigned replica shards                                                             |
+| elasticsearch_remote_info_num_nodes_connected                        | gauge      | 1           | Number of nodes currently connected to the remote cluster                                           |
+| elasticsearch_remote_info_num_proxy_sockets_connected                | gauge      | 1           | Number of proxy sockets currently connected to the remote cluster                                   |
+| elasticsearch_remote_info_max_connections_per_cluster                | gauge      | 1           | Maximum number of connections configured per remote cluster                                         |
+| elasticsearch_remote_info_stats_up                                   | gauge      | 0           | Was the last scrape of the Elasticsearch remote info endpoint successful                           |
+| elasticsearch_remote_info_stats_total_scrapes                        | counter    | 0           | Current total Elasticsearch remote info scrapes                                                     |
+| elasticsearch_remote_info_stats_json_parse_failures                  | counter    | 0           | Number of errors while parsing JSON from remote info endpoint                                       |
 
 ### Alerts & Recording Rules