1Search::Elasticsearch::UCsxenrPoCoolnS:te:raSirtbcauhtt:ie:cdE:l:PaNesortPliicnDsgoe(ca3ur)mcehn:t:aCtxinoPnool::Static::NoPing(3)
2
3
4

NAME

6       Search::Elasticsearch::CxnPool::Static::NoPing - A CxnPool for
7       connecting to a remote cluster without the ability to ping.
8

VERSION

10       version 8.00
11

SYNOPSIS

13           $e = Search::Elasticsearch->new(
14               cxn_pool => 'Static::NoPing'
15               nodes    => [
16                   'search1:9200',
17                   'search2:9200'
18               ],
19           );
20

DESCRIPTION

22       The Static::NoPing connection pool (like the Static pool) should be
23       used when your access to the cluster is limited.  However, the "Static"
24       pool needs to be able to ping nodes in the cluster, with a "HEAD /"
25       request.  If you can't ping your nodes, then you should use the
26       "Static::NoPing" connection pool instead.
27
28       Because the cluster cannot be pinged, this CxnPool cannot use a short
29       ping request to determine whether nodes are live or not - it just has
30       to send requests to the nodes to determine whether they are alive or
31       not.
32
33       Most of the time, a dead node will cause the request to fail quickly.
34       However, in situations where node failure takes time (eg malfunctioning
35       routers or firewalls), a failure may not be reported until the request
36       itself times out (see "request_timeout" in Search::Elasticsearch::Cxn).
37
38       Failed nodes will be retried regularly to check if they have recovered.
39
40       This class does Search::Elasticsearch::Role::CxnPool::Static::NoPing
41       and Search::Elasticsearch::Role::Is_Sync.
42

CONFIGURATION

44   "nodes"
45       The list of nodes to use to serve requests.  Can accept a single node,
46       multiple nodes, and defaults to "localhost:9200" if no "nodes" are
47       specified. See "node" in Search::Elasticsearch::Role::Cxn for details
48       of the node specification.
49
50   See also
51       •   "request_timeout" in Search::Elasticsearch::Role::Cxn
52
53       •   "dead_timeout" in Search::Elasticsearch::Role::Cxn
54
55       •   "max_dead_timeout" in Search::Elasticsearch::Role::Cxn
56
57   Inherited configuration
58       From Search::Elasticsearch::Role::CxnPool::Static::NoPing
59
60       •   max_retries
61
62       From Search::Elasticsearch::Role::CxnPool
63
64       •   randomize_cxns
65

METHODS

67   next_cxn()
68           $cxn = $cxn_pool->next_cxn
69
70       Returns the next available node  in round robin fashion - either a live
71       node which has previously responded successfully, or a previously
72       failed node which should be retried. If all nodes are dead, it will
73       throw a "NoNodes" error.
74
75   Inherited methods
76       From Search::Elasticsearch::Role::CxnPool::Static::NoPing
77
78       •   should_mark_dead()
79
80       •   schedule_check()
81
82       From Search::Elasticsearch::Role::CxnPool
83
84       •   cxn_factory()
85
86       •   logger()
87
88       •   serializer()
89
90       •   current_cxn_num()
91
92       •   cxns()
93
94       •   seed_nodes()
95
96       •   next_cxn_num()
97
98       •   set_cxns()
99
100       •   request_ok()
101
102       •   request_failed()
103
104       •   should_retry()
105
106       •   should_mark_dead()
107
108       •   cxns_str()
109
110       •   cxns_seeds_str()
111
112       •   retries()
113
114       •   reset_retries()
115

AUTHOR

117       Enrico Zimuel <enrico.zimuel@elastic.co>
118

120       This software is Copyright (c) 2022 by Elasticsearch BV.
121
122       This is free software, licensed under:
123
124         The Apache License, Version 2.0, January 2004
125
126
127
128perl v5.36.0                 Searc2h0:2:3E-l0a1s-t2i0csearch::CxnPool::Static::NoPing(3)
Impressum