blib/lib/Paws/XRay.pm untested

filter: Statementstmt 0.0% 0 / 254 Branchbran 0.0% 0 / 32 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 0.0% 0 / 41 Podpod 0.0% 0 / 40 totaltotal 0.0% 0 / 367 CC 17 SCAR 18.3
CC
17
Cov
0%
BatchGetAllTraces
12.0
GetAllGroups
12.0
GetAllSamplingRules
12.0
CRAP 6.2
1 package Paws::XRay;
2 use Moose;
3 sub service { 'xray' }
4 sub signing_name { 'xray' }
5 sub version { '2016-04-12' }
6 sub flattened_arrays { 0 }
7 has max_attempts => (is => 'ro', isa => 'Int', default => 5);
8 has retry => (is => 'ro', isa => 'HashRef', default => sub {
9 { base => 'rand', type => 'exponential', growth_factor => 2 }
10 });
11 has retriables => (is => 'ro', isa => 'ArrayRef', default => sub { [
12 ] });
13  
14 with 'Paws::API::Caller', 'Paws::API::EndpointResolver', 'Paws::Net::V4Signature', 'Paws::Net::RestJsonCaller';
15  
16
17 sub BatchGetTraces {
18 my $self = shift;
19 my $call_object = $self->new_with_coercions('Paws::XRay::BatchGetTraces', @_);
20 return $self->caller->do_call($self, $call_object);
21 }
22 sub CreateGroup {
23 my $self = shift;
24 my $call_object = $self->new_with_coercions('Paws::XRay::CreateGroup', @_);
25 return $self->caller->do_call($self, $call_object);
26 }
27 sub CreateSamplingRule {
28 my $self = shift;
29 my $call_object = $self->new_with_coercions('Paws::XRay::CreateSamplingRule', @_);
30 return $self->caller->do_call($self, $call_object);
31 }
32 sub DeleteGroup {
33 my $self = shift;
34 my $call_object = $self->new_with_coercions('Paws::XRay::DeleteGroup', @_);
35 return $self->caller->do_call($self, $call_object);
36 }
37 sub DeleteSamplingRule {
38 my $self = shift;
39 my $call_object = $self->new_with_coercions('Paws::XRay::DeleteSamplingRule', @_);
40 return $self->caller->do_call($self, $call_object);
41 }
42 sub GetEncryptionConfig {
43 my $self = shift;
44 my $call_object = $self->new_with_coercions('Paws::XRay::GetEncryptionConfig', @_);
45 return $self->caller->do_call($self, $call_object);
46 }
47 sub GetGroup {
48 my $self = shift;
49 my $call_object = $self->new_with_coercions('Paws::XRay::GetGroup', @_);
50 return $self->caller->do_call($self, $call_object);
51 }
52 sub GetGroups {
53 my $self = shift;
54 my $call_object = $self->new_with_coercions('Paws::XRay::GetGroups', @_);
55 return $self->caller->do_call($self, $call_object);
56 }
57 sub GetInsight {
58 my $self = shift;
59 my $call_object = $self->new_with_coercions('Paws::XRay::GetInsight', @_);
60 return $self->caller->do_call($self, $call_object);
61 }
62 sub GetInsightEvents {
63 my $self = shift;
64 my $call_object = $self->new_with_coercions('Paws::XRay::GetInsightEvents', @_);
65 return $self->caller->do_call($self, $call_object);
66 }
67 sub GetInsightImpactGraph {
68 my $self = shift;
69 my $call_object = $self->new_with_coercions('Paws::XRay::GetInsightImpactGraph', @_);
70 return $self->caller->do_call($self, $call_object);
71 }
72 sub GetInsightSummaries {
73 my $self = shift;
74 my $call_object = $self->new_with_coercions('Paws::XRay::GetInsightSummaries', @_);
75 return $self->caller->do_call($self, $call_object);
76 }
77 sub GetSamplingRules {
78 my $self = shift;
79 my $call_object = $self->new_with_coercions('Paws::XRay::GetSamplingRules', @_);
80 return $self->caller->do_call($self, $call_object);
81 }
82 sub GetSamplingStatisticSummaries {
83 my $self = shift;
84 my $call_object = $self->new_with_coercions('Paws::XRay::GetSamplingStatisticSummaries', @_);
85 return $self->caller->do_call($self, $call_object);
86 }
87 sub GetSamplingTargets {
88 my $self = shift;
89 my $call_object = $self->new_with_coercions('Paws::XRay::GetSamplingTargets', @_);
90 return $self->caller->do_call($self, $call_object);
91 }
92 sub GetServiceGraph {
93 my $self = shift;
94 my $call_object = $self->new_with_coercions('Paws::XRay::GetServiceGraph', @_);
95 return $self->caller->do_call($self, $call_object);
96 }
97 sub GetTimeSeriesServiceStatistics {
98 my $self = shift;
99 my $call_object = $self->new_with_coercions('Paws::XRay::GetTimeSeriesServiceStatistics', @_);
100 return $self->caller->do_call($self, $call_object);
101 }
102 sub GetTraceGraph {
103 my $self = shift;
104 my $call_object = $self->new_with_coercions('Paws::XRay::GetTraceGraph', @_);
105 return $self->caller->do_call($self, $call_object);
106 }
107 sub GetTraceSummaries {
108 my $self = shift;
109 my $call_object = $self->new_with_coercions('Paws::XRay::GetTraceSummaries', @_);
110 return $self->caller->do_call($self, $call_object);
111 }
112 sub ListTagsForResource {
113 my $self = shift;
114 my $call_object = $self->new_with_coercions('Paws::XRay::ListTagsForResource', @_);
115 return $self->caller->do_call($self, $call_object);
116 }
117 sub PutEncryptionConfig {
118 my $self = shift;
119 my $call_object = $self->new_with_coercions('Paws::XRay::PutEncryptionConfig', @_);
120 return $self->caller->do_call($self, $call_object);
121 }
122 sub PutTelemetryRecords {
123 my $self = shift;
124 my $call_object = $self->new_with_coercions('Paws::XRay::PutTelemetryRecords', @_);
125 return $self->caller->do_call($self, $call_object);
126 }
127 sub PutTraceSegments {
128 my $self = shift;
129 my $call_object = $self->new_with_coercions('Paws::XRay::PutTraceSegments', @_);
130 return $self->caller->do_call($self, $call_object);
131 }
132 sub TagResource {
133 my $self = shift;
134 my $call_object = $self->new_with_coercions('Paws::XRay::TagResource', @_);
135 return $self->caller->do_call($self, $call_object);
136 }
137 sub UntagResource {
138 my $self = shift;
139 my $call_object = $self->new_with_coercions('Paws::XRay::UntagResource', @_);
140 return $self->caller->do_call($self, $call_object);
141 }
142 sub UpdateGroup {
143 my $self = shift;
144 my $call_object = $self->new_with_coercions('Paws::XRay::UpdateGroup', @_);
145 return $self->caller->do_call($self, $call_object);
146 }
147 sub UpdateSamplingRule {
148 my $self = shift;
149 my $call_object = $self->new_with_coercions('Paws::XRay::UpdateSamplingRule', @_);
150 return $self->caller->do_call($self, $call_object);
151 }
152
153 sub BatchGetAllTraces {
154 my $self = shift;
155  
156 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
157 my $result = $self->BatchGetTraces(@_);
158 my $next_result = $result;
159  
160 if (not defined $callback) {
161 while ($next_result->NextToken) {
162 $next_result = $self->BatchGetTraces(@_, NextToken => $next_result->NextToken);
163 push @{ $result->Traces }, @{ $next_result->Traces };
164 }
165 return $result;
166 } else {
167 while ($result->NextToken) {
168 $callback->($_ => 'Traces') foreach (@{ $result->Traces });
169 $result = $self->BatchGetTraces(@_, NextToken => $result->NextToken);
170 }
171 $callback->($_ => 'Traces') foreach (@{ $result->Traces });
172 }
173  
174 return undef
175 }
176 sub GetAllGroups {
177 my $self = shift;
178  
179 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
180 my $result = $self->GetGroups(@_);
181 my $next_result = $result;
182  
183 if (not defined $callback) {
184 while ($next_result->NextToken) {
185 $next_result = $self->GetGroups(@_, NextToken => $next_result->NextToken);
186 push @{ $result->Groups }, @{ $next_result->Groups };
187 }
188 return $result;
189 } else {
190 while ($result->NextToken) {
191 $callback->($_ => 'Groups') foreach (@{ $result->Groups });
192 $result = $self->GetGroups(@_, NextToken => $result->NextToken);
193 }
194 $callback->($_ => 'Groups') foreach (@{ $result->Groups });
195 }
196  
197 return undef
198 }
199 sub GetAllSamplingRules {
200 my $self = shift;
201  
202 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
203 my $result = $self->GetSamplingRules(@_);
204 my $next_result = $result;
205  
206 if (not defined $callback) {
207 while ($next_result->NextToken) {
208 $next_result = $self->GetSamplingRules(@_, NextToken => $next_result->NextToken);
209 push @{ $result->SamplingRuleRecords }, @{ $next_result->SamplingRuleRecords };
210 }
211 return $result;
212 } else {
213 while ($result->NextToken) {
214 $callback->($_ => 'SamplingRuleRecords') foreach (@{ $result->SamplingRuleRecords });
215 $result = $self->GetSamplingRules(@_, NextToken => $result->NextToken);
216 }
217 $callback->($_ => 'SamplingRuleRecords') foreach (@{ $result->SamplingRuleRecords });
218 }
219  
220 return undef
221 }
222 sub GetAllSamplingStatisticSummaries {
223 my $self = shift;
224  
225 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
226 my $result = $self->GetSamplingStatisticSummaries(@_);
227 my $next_result = $result;
228  
229 if (not defined $callback) {
230 while ($next_result->NextToken) {
231 $next_result = $self->GetSamplingStatisticSummaries(@_, NextToken => $next_result->NextToken);
232 push @{ $result->SamplingStatisticSummaries }, @{ $next_result->SamplingStatisticSummaries };
233 }
234 return $result;
235 } else {
236 while ($result->NextToken) {
237 $callback->($_ => 'SamplingStatisticSummaries') foreach (@{ $result->SamplingStatisticSummaries });
238 $result = $self->GetSamplingStatisticSummaries(@_, NextToken => $result->NextToken);
239 }
240 $callback->($_ => 'SamplingStatisticSummaries') foreach (@{ $result->SamplingStatisticSummaries });
241 }
242  
243 return undef
244 }
245 sub GetAllServiceGraph {
246 my $self = shift;
247  
248 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
249 my $result = $self->GetServiceGraph(@_);
250 my $next_result = $result;
251  
252 if (not defined $callback) {
253 while ($next_result->NextToken) {
254 $next_result = $self->GetServiceGraph(@_, NextToken => $next_result->NextToken);
255 push @{ $result->Services }, @{ $next_result->Services };
256 }
257 return $result;
258 } else {
259 while ($result->NextToken) {
260 $callback->($_ => 'Services') foreach (@{ $result->Services });
261 $result = $self->GetServiceGraph(@_, NextToken => $result->NextToken);
262 }
263 $callback->($_ => 'Services') foreach (@{ $result->Services });
264 }
265  
266 return undef
267 }
268 sub GetAllTimeSeriesServiceStatistics {
269 my $self = shift;
270  
271 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
272 my $result = $self->GetTimeSeriesServiceStatistics(@_);
273 my $next_result = $result;
274  
275 if (not defined $callback) {
276 while ($next_result->NextToken) {
277 $next_result = $self->GetTimeSeriesServiceStatistics(@_, NextToken => $next_result->NextToken);
278 push @{ $result->TimeSeriesServiceStatistics }, @{ $next_result->TimeSeriesServiceStatistics };
279 }
280 return $result;
281 } else {
282 while ($result->NextToken) {
283 $callback->($_ => 'TimeSeriesServiceStatistics') foreach (@{ $result->TimeSeriesServiceStatistics });
284 $result = $self->GetTimeSeriesServiceStatistics(@_, NextToken => $result->NextToken);
285 }
286 $callback->($_ => 'TimeSeriesServiceStatistics') foreach (@{ $result->TimeSeriesServiceStatistics });
287 }
288  
289 return undef
290 }
291 sub GetAllTraceGraph {
292 my $self = shift;
293  
294 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
295 my $result = $self->GetTraceGraph(@_);
296 my $next_result = $result;
297  
298 if (not defined $callback) {
299 while ($next_result->NextToken) {
300 $next_result = $self->GetTraceGraph(@_, NextToken => $next_result->NextToken);
301 push @{ $result->Services }, @{ $next_result->Services };
302 }
303 return $result;
304 } else {
305 while ($result->NextToken) {
306 $callback->($_ => 'Services') foreach (@{ $result->Services });
307 $result = $self->GetTraceGraph(@_, NextToken => $result->NextToken);
308 }
309 $callback->($_ => 'Services') foreach (@{ $result->Services });
310 }
311  
312 return undef
313 }
314 sub GetAllTraceSummaries {
315 my $self = shift;
316  
317 my $callback = shift @_ if (ref($_[0]) eq 'CODE');
318 my $result = $self->GetTraceSummaries(@_);
319 my $next_result = $result;
320  
321 if (not defined $callback) {
322 while ($next_result->NextToken) {
323 $next_result = $self->GetTraceSummaries(@_, NextToken => $next_result->NextToken);
324 push @{ $result->TraceSummaries }, @{ $next_result->TraceSummaries };
325 }
326 return $result;
327 } else {
328 while ($result->NextToken) {
329 $callback->($_ => 'TraceSummaries') foreach (@{ $result->TraceSummaries });
330 $result = $self->GetTraceSummaries(@_, NextToken => $result->NextToken);
331 }
332 $callback->($_ => 'TraceSummaries') foreach (@{ $result->TraceSummaries });
333 }
334  
335 return undef
336 }
337  
338  
339 sub operations { qw/BatchGetTraces CreateGroup CreateSamplingRule DeleteGroup DeleteSamplingRule GetEncryptionConfig GetGroup GetGroups GetInsight GetInsightEvents GetInsightImpactGraph GetInsightSummaries GetSamplingRules GetSamplingStatisticSummaries GetSamplingTargets GetServiceGraph GetTimeSeriesServiceStatistics GetTraceGraph GetTraceSummaries ListTagsForResource PutEncryptionConfig PutTelemetryRecords PutTraceSegments TagResource UntagResource UpdateGroup UpdateSamplingRule / }
340  
341 1;
342  
343 ### main pod documentation begin ###
344  
345 =head1 NAME
346  
347 Paws::XRay - Perl Interface to AWS AWS X-Ray
348  
349 =head1 SYNOPSIS
350  
351 use Paws;
352  
353 my $obj = Paws->service('XRay');
354 my $res = $obj->Method(
355 Arg1 => $val1,
356 Arg2 => [ 'V1', 'V2' ],
357 # if Arg3 is an object, the HashRef will be used as arguments to the constructor
358 # of the arguments type
359 Arg3 => { Att1 => 'Val1' },
360 # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
361 # the constructor of the arguments type
362 Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
363 );
364  
365 =head1 DESCRIPTION
366  
367 AWS X-Ray provides APIs for managing debug traces and retrieving
368 service maps and other data created by processing those traces.
369  
370 For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12>
371  
372  
373 =head1 METHODS
374  
375 =head2 BatchGetTraces
376  
377 =over
378  
379 =item TraceIds => ArrayRef[Str|Undef]
380  
381 =item [NextToken => Str]
382  
383  
384 =back
385  
386 Each argument is described in detail in: L<Paws::XRay::BatchGetTraces>
387  
388 Returns: a L<Paws::XRay::BatchGetTracesResult> instance
389  
390 Retrieves a list of traces specified by ID. Each trace is a collection
391 of segment documents that originates from a single request. Use
392 C<GetTraceSummaries> to get a list of trace IDs.
393  
394  
395 =head2 CreateGroup
396  
397 =over
398  
399 =item GroupName => Str
400  
401 =item [FilterExpression => Str]
402  
403 =item [InsightsConfiguration => L<Paws::XRay::InsightsConfiguration>]
404  
405 =item [Tags => ArrayRef[L<Paws::XRay::Tag>]]
406  
407  
408 =back
409  
410 Each argument is described in detail in: L<Paws::XRay::CreateGroup>
411  
412 Returns: a L<Paws::XRay::CreateGroupResult> instance
413  
414 Creates a group resource with a name and a filter expression.
415  
416  
417 =head2 CreateSamplingRule
418  
419 =over
420  
421 =item SamplingRule => L<Paws::XRay::SamplingRule>
422  
423 =item [Tags => ArrayRef[L<Paws::XRay::Tag>]]
424  
425  
426 =back
427  
428 Each argument is described in detail in: L<Paws::XRay::CreateSamplingRule>
429  
430 Returns: a L<Paws::XRay::CreateSamplingRuleResult> instance
431  
432 Creates a rule to control sampling behavior for instrumented
433 applications. Services retrieve rules with GetSamplingRules, and
434 evaluate each rule in ascending order of I<priority> for each request.
435 If a rule matches, the service records a trace, borrowing it from the
436 reservoir size. After 10 seconds, the service reports back to X-Ray
437 with GetSamplingTargets to get updated versions of each in-use rule.
438 The updated rule contains a trace quota that the service can use
439 instead of borrowing from the reservoir.
440  
441  
442 =head2 DeleteGroup
443  
444 =over
445  
446 =item [GroupARN => Str]
447  
448 =item [GroupName => Str]
449  
450  
451 =back
452  
453 Each argument is described in detail in: L<Paws::XRay::DeleteGroup>
454  
455 Returns: a L<Paws::XRay::DeleteGroupResult> instance
456  
457 Deletes a group resource.
458  
459  
460 =head2 DeleteSamplingRule
461  
462 =over
463  
464 =item [RuleARN => Str]
465  
466 =item [RuleName => Str]
467  
468  
469 =back
470  
471 Each argument is described in detail in: L<Paws::XRay::DeleteSamplingRule>
472  
473 Returns: a L<Paws::XRay::DeleteSamplingRuleResult> instance
474  
475 Deletes a sampling rule.
476  
477  
478 =head2 GetEncryptionConfig
479  
480  
481  
482  
483  
484  
485 Each argument is described in detail in: L<Paws::XRay::GetEncryptionConfig>
486  
487 Returns: a L<Paws::XRay::GetEncryptionConfigResult> instance
488  
489 Retrieves the current encryption configuration for X-Ray data.
490  
491  
492 =head2 GetGroup
493  
494 =over
495  
496 =item [GroupARN => Str]
497  
498 =item [GroupName => Str]
499  
500  
501 =back
502  
503 Each argument is described in detail in: L<Paws::XRay::GetGroup>
504  
505 Returns: a L<Paws::XRay::GetGroupResult> instance
506  
507 Retrieves group resource details.
508  
509  
510 =head2 GetGroups
511  
512 =over
513  
514 =item [NextToken => Str]
515  
516  
517 =back
518  
519 Each argument is described in detail in: L<Paws::XRay::GetGroups>
520  
521 Returns: a L<Paws::XRay::GetGroupsResult> instance
522  
523 Retrieves all active group details.
524  
525  
526 =head2 GetInsight
527  
528 =over
529  
530 =item InsightId => Str
531  
532  
533 =back
534  
535 Each argument is described in detail in: L<Paws::XRay::GetInsight>
536  
537 Returns: a L<Paws::XRay::GetInsightResult> instance
538  
539 Retrieves the summary information of an insight. This includes impact
540 to clients and root cause services, the top anomalous services, the
541 category, the state of the insight, and the start and end time of the
542 insight.
543  
544  
545 =head2 GetInsightEvents
546  
547 =over
548  
549 =item InsightId => Str
550  
551 =item [MaxResults => Int]
552  
553 =item [NextToken => Str]
554  
555  
556 =back
557  
558 Each argument is described in detail in: L<Paws::XRay::GetInsightEvents>
559  
560 Returns: a L<Paws::XRay::GetInsightEventsResult> instance
561  
562 X-Ray reevaluates insights periodically until they're resolved, and
563 records each intermediate state as an event. You can review an
564 insight's events in the Impact Timeline on the Inspect page in the
565 X-Ray console.
566  
567  
568 =head2 GetInsightImpactGraph
569  
570 =over
571  
572 =item EndTime => Str
573  
574 =item InsightId => Str
575  
576 =item StartTime => Str
577  
578 =item [NextToken => Str]
579  
580  
581 =back
582  
583 Each argument is described in detail in: L<Paws::XRay::GetInsightImpactGraph>
584  
585 Returns: a L<Paws::XRay::GetInsightImpactGraphResult> instance
586  
587 Retrieves a service graph structure filtered by the specified insight.
588 The service graph is limited to only structural information. For a
589 complete service graph, use this API with the GetServiceGraph API.
590  
591  
592 =head2 GetInsightSummaries
593  
594 =over
595  
596 =item EndTime => Str
597  
598 =item StartTime => Str
599  
600 =item [GroupARN => Str]
601  
602 =item [GroupName => Str]
603  
604 =item [MaxResults => Int]
605  
606 =item [NextToken => Str]
607  
608 =item [States => ArrayRef[Str|Undef]]
609  
610  
611 =back
612  
613 Each argument is described in detail in: L<Paws::XRay::GetInsightSummaries>
614  
615 Returns: a L<Paws::XRay::GetInsightSummariesResult> instance
616  
617 Retrieves the summaries of all insights in the specified group matching
618 the provided filter values.
619  
620  
621 =head2 GetSamplingRules
622  
623 =over
624  
625 =item [NextToken => Str]
626  
627  
628 =back
629  
630 Each argument is described in detail in: L<Paws::XRay::GetSamplingRules>
631  
632 Returns: a L<Paws::XRay::GetSamplingRulesResult> instance
633  
634 Retrieves all sampling rules.
635  
636  
637 =head2 GetSamplingStatisticSummaries
638  
639 =over
640  
641 =item [NextToken => Str]
642  
643  
644 =back
645  
646 Each argument is described in detail in: L<Paws::XRay::GetSamplingStatisticSummaries>
647  
648 Returns: a L<Paws::XRay::GetSamplingStatisticSummariesResult> instance
649  
650 Retrieves information about recent sampling results for all sampling
651 rules.
652  
653  
654 =head2 GetSamplingTargets
655  
656 =over
657  
658 =item SamplingStatisticsDocuments => ArrayRef[L<Paws::XRay::SamplingStatisticsDocument>]
659  
660  
661 =back
662  
663 Each argument is described in detail in: L<Paws::XRay::GetSamplingTargets>
664  
665 Returns: a L<Paws::XRay::GetSamplingTargetsResult> instance
666  
667 Requests a sampling quota for rules that the service is using to sample
668 requests.
669  
670  
671 =head2 GetServiceGraph
672  
673 =over
674  
675 =item EndTime => Str
676  
677 =item StartTime => Str
678  
679 =item [GroupARN => Str]
680  
681 =item [GroupName => Str]
682  
683 =item [NextToken => Str]
684  
685  
686 =back
687  
688 Each argument is described in detail in: L<Paws::XRay::GetServiceGraph>
689  
690 Returns: a L<Paws::XRay::GetServiceGraphResult> instance
691  
692 Retrieves a document that describes services that process incoming
693 requests, and downstream services that they call as a result. Root
694 services process incoming requests and make calls to downstream
695 services. Root services are applications that use the AWS X-Ray SDK
696 (https://docs.aws.amazon.com/xray/index.html). Downstream services can
697 be other applications, AWS resources, HTTP web APIs, or SQL databases.
698  
699  
700 =head2 GetTimeSeriesServiceStatistics
701  
702 =over
703  
704 =item EndTime => Str
705  
706 =item StartTime => Str
707  
708 =item [EntitySelectorExpression => Str]
709  
710 =item [ForecastStatistics => Bool]
711  
712 =item [GroupARN => Str]
713  
714 =item [GroupName => Str]
715  
716 =item [NextToken => Str]
717  
718 =item [Period => Int]
719  
720  
721 =back
722  
723 Each argument is described in detail in: L<Paws::XRay::GetTimeSeriesServiceStatistics>
724  
725 Returns: a L<Paws::XRay::GetTimeSeriesServiceStatisticsResult> instance
726  
727 Get an aggregation of service statistics defined by a specific time
728 range.
729  
730  
731 =head2 GetTraceGraph
732  
733 =over
734  
735 =item TraceIds => ArrayRef[Str|Undef]
736  
737 =item [NextToken => Str]
738  
739  
740 =back
741  
742 Each argument is described in detail in: L<Paws::XRay::GetTraceGraph>
743  
744 Returns: a L<Paws::XRay::GetTraceGraphResult> instance
745  
746 Retrieves a service graph for one or more specific trace IDs.
747  
748  
749 =head2 GetTraceSummaries
750  
751 =over
752  
753 =item EndTime => Str
754  
755 =item StartTime => Str
756  
757 =item [FilterExpression => Str]
758  
759 =item [NextToken => Str]
760  
761 =item [Sampling => Bool]
762  
763 =item [SamplingStrategy => L<Paws::XRay::SamplingStrategy>]
764  
765 =item [TimeRangeType => Str]
766  
767  
768 =back
769  
770 Each argument is described in detail in: L<Paws::XRay::GetTraceSummaries>
771  
772 Returns: a L<Paws::XRay::GetTraceSummariesResult> instance
773  
774 Retrieves IDs and annotations for traces available for a specified time
775 frame using an optional filter. To get the full traces, pass the trace
776 IDs to C<BatchGetTraces>.
777  
778 A filter expression can target traced requests that hit specific
779 service nodes or edges, have errors, or come from a known user. For
780 example, the following filter expression targets traces that pass
781 through C<api.example.com>:
782  
783 C<service("api.example.com")>
784  
785 This filter expression finds traces that have an annotation named
786 C<account> with the value C<12345>:
787  
788 C<annotation.account = "12345">
789  
790 For a full list of indexed fields and keywords that you can use in
791 filter expressions, see Using Filter Expressions
792 (https://docs.aws.amazon.com/xray/latest/devguide/xray-console-filters.html)
793 in the I<AWS X-Ray Developer Guide>.
794  
795  
796 =head2 ListTagsForResource
797  
798 =over
799  
800 =item ResourceARN => Str
801  
802 =item [NextToken => Str]
803  
804  
805 =back
806  
807 Each argument is described in detail in: L<Paws::XRay::ListTagsForResource>
808  
809 Returns: a L<Paws::XRay::ListTagsForResourceResponse> instance
810  
811 Returns a list of tags that are applied to the specified AWS X-Ray
812 group or sampling rule.
813  
814  
815 =head2 PutEncryptionConfig
816  
817 =over
818  
819 =item Type => Str
820  
821 =item [KeyId => Str]
822  
823  
824 =back
825  
826 Each argument is described in detail in: L<Paws::XRay::PutEncryptionConfig>
827  
828 Returns: a L<Paws::XRay::PutEncryptionConfigResult> instance
829  
830 Updates the encryption configuration for X-Ray data.
831  
832  
833 =head2 PutTelemetryRecords
834  
835 =over
836  
837 =item TelemetryRecords => ArrayRef[L<Paws::XRay::TelemetryRecord>]
838  
839 =item [EC2InstanceId => Str]
840  
841 =item [Hostname => Str]
842  
843 =item [ResourceARN => Str]
844  
845  
846 =back
847  
848 Each argument is described in detail in: L<Paws::XRay::PutTelemetryRecords>
849  
850 Returns: a L<Paws::XRay::PutTelemetryRecordsResult> instance
851  
852 Used by the AWS X-Ray daemon to upload telemetry.
853  
854  
855 =head2 PutTraceSegments
856  
857 =over
858  
859 =item TraceSegmentDocuments => ArrayRef[Str|Undef]
860  
861  
862 =back
863  
864 Each argument is described in detail in: L<Paws::XRay::PutTraceSegments>
865  
866 Returns: a L<Paws::XRay::PutTraceSegmentsResult> instance
867  
868 Uploads segment documents to AWS X-Ray. The X-Ray SDK
869 (https://docs.aws.amazon.com/xray/index.html) generates segment
870 documents and sends them to the X-Ray daemon, which uploads them in
871 batches. A segment document can be a completed segment, an in-progress
872 segment, or an array of subsegments.
873  
874 Segments must include the following fields. For the full segment
875 document schema, see AWS X-Ray Segment Documents
876 (https://docs.aws.amazon.com/xray/latest/devguide/xray-api-segmentdocuments.html)
877 in the I<AWS X-Ray Developer Guide>.
878  
879 B<Required segment document fields>
880  
881 =over
882  
883 =item *
884  
885 C<name> - The name of the service that handled the request.
886  
887 =item *
888  
889 C<id> - A 64-bit identifier for the segment, unique among segments in
890 the same trace, in 16 hexadecimal digits.
891  
892 =item *
893  
894 C<trace_id> - A unique identifier that connects all segments and
895 subsegments originating from a single client request.
896  
897 =item *
898  
899 C<start_time> - Time the segment or subsegment was created, in floating
900 point seconds in epoch time, accurate to milliseconds. For example,
901 C<1480615200.010> or C<1.480615200010E9>.
902  
903 =item *
904  
905 C<end_time> - Time the segment or subsegment was closed. For example,
906 C<1480615200.090> or C<1.480615200090E9>. Specify either an C<end_time>
907 or C<in_progress>.
908  
909 =item *
910  
911 C<in_progress> - Set to C<true> instead of specifying an C<end_time> to
912 record that a segment has been started, but is not complete. Send an
913 in-progress segment when your application receives a request that will
914 take a long time to serve, to trace that the request was received. When
915 the response is sent, send the complete segment to overwrite the
916 in-progress segment.
917  
918 =back
919  
920 A C<trace_id> consists of three numbers separated by hyphens. For
921 example, 1-58406520-a006649127e371903a2de979. This includes:
922  
923 B<Trace ID Format>
924  
925 =over
926  
927 =item *
928  
929 The version number, for instance, C<1>.
930  
931 =item *
932  
933 The time of the original request, in Unix epoch time, in 8 hexadecimal
934 digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is
935 C<1480615200> seconds, or C<58406520> in hexadecimal.
936  
937 =item *
938  
939 A 96-bit identifier for the trace, globally unique, in 24 hexadecimal
940 digits.
941  
942 =back
943  
944  
945  
946 =head2 TagResource
947  
948 =over
949  
950 =item ResourceARN => Str
951  
952 =item Tags => ArrayRef[L<Paws::XRay::Tag>]
953  
954  
955 =back
956  
957 Each argument is described in detail in: L<Paws::XRay::TagResource>
958  
959 Returns: a L<Paws::XRay::TagResourceResponse> instance
960  
961 Applies tags to an existing AWS X-Ray group or sampling rule.
962  
963  
964 =head2 UntagResource
965  
966 =over
967  
968 =item ResourceARN => Str
969  
970 =item TagKeys => ArrayRef[Str|Undef]
971  
972  
973 =back
974  
975 Each argument is described in detail in: L<Paws::XRay::UntagResource>
976  
977 Returns: a L<Paws::XRay::UntagResourceResponse> instance
978  
979 Removes tags from an AWS X-Ray group or sampling rule. You cannot edit
980 or delete system tags (those with an C<aws:> prefix).
981  
982  
983 =head2 UpdateGroup
984  
985 =over
986  
987 =item [FilterExpression => Str]
988  
989 =item [GroupARN => Str]
990  
991 =item [GroupName => Str]
992  
993 =item [InsightsConfiguration => L<Paws::XRay::InsightsConfiguration>]
994  
995  
996 =back
997  
998 Each argument is described in detail in: L<Paws::XRay::UpdateGroup>
999  
1000 Returns: a L<Paws::XRay::UpdateGroupResult> instance
1001  
1002 Updates a group resource.
1003  
1004  
1005 =head2 UpdateSamplingRule
1006  
1007 =over
1008  
1009 =item SamplingRuleUpdate => L<Paws::XRay::SamplingRuleUpdate>
1010  
1011  
1012 =back
1013  
1014 Each argument is described in detail in: L<Paws::XRay::UpdateSamplingRule>
1015  
1016 Returns: a L<Paws::XRay::UpdateSamplingRuleResult> instance
1017  
1018 Modifies a sampling rule's configuration.
1019  
1020  
1021  
1022  
1023 =head1 PAGINATORS
1024  
1025 Paginator methods are helpers that repetively call methods that return partial results
1026  
1027 =head2 BatchGetAllTraces(sub { },TraceIds => ArrayRef[Str|Undef], [NextToken => Str])
1028  
1029 =head2 BatchGetAllTraces(TraceIds => ArrayRef[Str|Undef], [NextToken => Str])
1030  
1031  
1032 If passed a sub as first parameter, it will call the sub for each element found in :
1033  
1034 - Traces, passing the object as the first parameter, and the string 'Traces' as the second parameter
1035  
1036 If not, it will return a a L<Paws::XRay::BatchGetTracesResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1037  
1038  
1039 =head2 GetAllGroups(sub { },[NextToken => Str])
1040  
1041 =head2 GetAllGroups([NextToken => Str])
1042  
1043  
1044 If passed a sub as first parameter, it will call the sub for each element found in :
1045  
1046 - Groups, passing the object as the first parameter, and the string 'Groups' as the second parameter
1047  
1048 If not, it will return a a L<Paws::XRay::GetGroupsResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1049  
1050  
1051 =head2 GetAllSamplingRules(sub { },[NextToken => Str])
1052  
1053 =head2 GetAllSamplingRules([NextToken => Str])
1054  
1055  
1056 If passed a sub as first parameter, it will call the sub for each element found in :
1057  
1058 - SamplingRuleRecords, passing the object as the first parameter, and the string 'SamplingRuleRecords' as the second parameter
1059  
1060 If not, it will return a a L<Paws::XRay::GetSamplingRulesResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1061  
1062  
1063 =head2 GetAllSamplingStatisticSummaries(sub { },[NextToken => Str])
1064  
1065 =head2 GetAllSamplingStatisticSummaries([NextToken => Str])
1066  
1067  
1068 If passed a sub as first parameter, it will call the sub for each element found in :
1069  
1070 - SamplingStatisticSummaries, passing the object as the first parameter, and the string 'SamplingStatisticSummaries' as the second parameter
1071  
1072 If not, it will return a a L<Paws::XRay::GetSamplingStatisticSummariesResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1073  
1074  
1075 =head2 GetAllServiceGraph(sub { },EndTime => Str, StartTime => Str, [GroupARN => Str, GroupName => Str, NextToken => Str])
1076  
1077 =head2 GetAllServiceGraph(EndTime => Str, StartTime => Str, [GroupARN => Str, GroupName => Str, NextToken => Str])
1078  
1079  
1080 If passed a sub as first parameter, it will call the sub for each element found in :
1081  
1082 - Services, passing the object as the first parameter, and the string 'Services' as the second parameter
1083  
1084 If not, it will return a a L<Paws::XRay::GetServiceGraphResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1085  
1086  
1087 =head2 GetAllTimeSeriesServiceStatistics(sub { },EndTime => Str, StartTime => Str, [EntitySelectorExpression => Str, ForecastStatistics => Bool, GroupARN => Str, GroupName => Str, NextToken => Str, Period => Int])
1088  
1089 =head2 GetAllTimeSeriesServiceStatistics(EndTime => Str, StartTime => Str, [EntitySelectorExpression => Str, ForecastStatistics => Bool, GroupARN => Str, GroupName => Str, NextToken => Str, Period => Int])
1090  
1091  
1092 If passed a sub as first parameter, it will call the sub for each element found in :
1093  
1094 - TimeSeriesServiceStatistics, passing the object as the first parameter, and the string 'TimeSeriesServiceStatistics' as the second parameter
1095  
1096 If not, it will return a a L<Paws::XRay::GetTimeSeriesServiceStatisticsResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1097  
1098  
1099 =head2 GetAllTraceGraph(sub { },TraceIds => ArrayRef[Str|Undef], [NextToken => Str])
1100  
1101 =head2 GetAllTraceGraph(TraceIds => ArrayRef[Str|Undef], [NextToken => Str])
1102  
1103  
1104 If passed a sub as first parameter, it will call the sub for each element found in :
1105  
1106 - Services, passing the object as the first parameter, and the string 'Services' as the second parameter
1107  
1108 If not, it will return a a L<Paws::XRay::GetTraceGraphResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1109  
1110  
1111 =head2 GetAllTraceSummaries(sub { },EndTime => Str, StartTime => Str, [FilterExpression => Str, NextToken => Str, Sampling => Bool, SamplingStrategy => L<Paws::XRay::SamplingStrategy>, TimeRangeType => Str])
1112  
1113 =head2 GetAllTraceSummaries(EndTime => Str, StartTime => Str, [FilterExpression => Str, NextToken => Str, Sampling => Bool, SamplingStrategy => L<Paws::XRay::SamplingStrategy>, TimeRangeType => Str])
1114  
1115  
1116 If passed a sub as first parameter, it will call the sub for each element found in :
1117  
1118 - TraceSummaries, passing the object as the first parameter, and the string 'TraceSummaries' as the second parameter
1119  
1120 If not, it will return a a L<Paws::XRay::GetTraceSummariesResult> instance with all the C<param>s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
1121  
1122  
1123  
1124  
1125  
1126 =head1 SEE ALSO
1127  
1128 This service class forms part of L<Paws>
1129  
1130 =head1 BUGS and CONTRIBUTIONS
1131  
1132 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
1133  
1134 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
1135  
1136 =cut
1137