Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
BSON	[ DIR ]	drwxr-xr-x
GridFSBucket	[ DIR ]	drwxr-xr-x
Op	[ DIR ]	drwxr-xr-x
QueryResult	[ DIR ]	drwxr-xr-x
Role	[ DIR ]	drwxr-xr-x
Upgrading	[ DIR ]	drwxr-xr-x
BulkWrite.pm	13.6 KB	-rw-r--r--
BulkWriteResult.pm	13.99 KB	-rw-r--r--
BulkWriteView.pm	8.19 KB	-rw-r--r--
ChangeStream.pm	10.71 KB	-rw-r--r--
ClientSession.pm	33.85 KB	-rw-r--r--
Code.pm	1.56 KB	-rw-r--r--
Collection.pm	105.71 KB	-rw-r--r--
CommandResult.pm	5.14 KB	-rw-r--r--
Cursor.pm	26.08 KB	-rw-r--r--
DBRef.pm	1.59 KB	-rw-r--r--
DataTypes.pod	12.78 KB	-rw-r--r--
Database.pm	28.5 KB	-rw-r--r--
DeleteResult.pm	2.41 KB	-rw-r--r--
Error.pm	18.86 KB	-rw-r--r--
Examples.pod	14.35 KB	-rw-r--r--
GridFSBucket.pm	27.45 KB	-rw-r--r--
IndexView.pm	19.83 KB	-rw-r--r--
InsertManyResult.pm	3.41 KB	-rw-r--r--
InsertOneResult.pm	2.32 KB	-rw-r--r--
MongoClient.pm	97.69 KB	-rw-r--r--
Monitoring.pod	7.29 KB	-rw-r--r--
OID.pm	2.17 KB	-rw-r--r--
QueryResult.pm	11.24 KB	-rw-r--r--
ReadConcern.pm	3.87 KB	-rw-r--r--
ReadPreference.pm	8.54 KB	-rw-r--r--
Timestamp.pm	1.6 KB	-rw-r--r--
Tutorial.pod	9.18 KB	-rw-r--r--
UnacknowledgedResult.pm	1.98 KB	-rw-r--r--
UpdateResult.pm	3.54 KB	-rw-r--r--
Upgrading.pod	12.18 KB	-rw-r--r--
WriteConcern.pm	5.05 KB	-rw-r--r--
_Constants.pm	2.87 KB	-rw-r--r--
_Credential.pm	13.58 KB	-rw-r--r--
_Dispatcher.pm	11.87 KB	-rw-r--r--
_Link.pm	18.18 KB	-rw-r--r--
_Platform.pm	897 B	-rw-r--r--
_Protocol.pm	23.46 KB	-rw-r--r--
_Server.pm	8.31 KB	-rw-r--r--
_ServerSession.pm	3.41 KB	-rw-r--r--
_SessionPool.pm	3.86 KB	-rw-r--r--
_Topology.pm	46.27 KB	-rw-r--r--
_TransactionOptions.pm	3.72 KB	-rw-r--r--
_Types.pm	7.11 KB	-rw-r--r--
_URI.pm	19.46 KB	-rw-r--r--

Code Editor : Monitoring.pod

#  Copyright 2018 - present MongoDB, Inc.
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#  http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.

# PODNAME: MongoDB::Monitoring
# ABSTRACT: Internal event monitoring API for instrumentation

# vim: set ts=4 sts=4 sw=4 et tw=75:

__END__

=pod

=encoding UTF-8

=head1 NAME

MongoDB::Monitoring - Internal event monitoring API for instrumentation

=head1 VERSION

version v2.2.2

=head1 DESCRIPTION

The L<MongoDB::MongoClient> takes an optional C<monitoring_callback>
attribute, which can be used to monitor events that occur during the
operation of the driver.

The API is very simple: given a code reference, a hashref for each event
is passed to the code reference.  Here is a simple example that just
accumulates events in an array:

our @events;
    my $cb = sub { push @events, $_[0] };

MongoDB->connect( $uri, { monitoring_callback => $cb } );

=head1 EVENT TYPES

Every event is a hash reference, with a C<type> field indicating the type,
e.g. C<command_started>.  Each type is described below.

=head2 Command Monitoring

These events are fired for commands directly to the wire and the response.

=head3 command_started

This event is sent just before a command is put one the wire.  It will be
followed by either a C<command_succeeded> or C<command_failed> event.

Fields:

=over 4

=item *

type: "command_started"

=item *

databaseName: the name of the database to which the command applies

=item *

commandName: the name of the command being executed; for legacy operations that don't use commands, the driver will convert them to appear as if they are in command form.

=item *

command: a hash reference representing the full command to be sent

=item *

requestId: the request identifier sent to the server

=item *

connectionId: address and port of the destination server

=back

=head3 command_succeeded

This event is sent just after a command reply is received, but only if the
database reply document contains a non-false C<ok> field.  NOTE: write
errors will have C<ok:1> even though they have write errors; for writes,
success indicates that the write attempt was valid, not that the write
succeeded.

Fields:

=over 4

=item *

type: "command_succeeded"

=item *

commandName: the name of the command being executed

=item *

durationSecs: the elapsed time in seconds since the C<command_started> event.

=item *

reply: a hash reference representing the full database reply

=item *

requestId: the request identifier sent to the server

=item *

connectionId: address and port of the destination server

=back

=head3 command_failed

This event is sent just after a command reply is received, but only if the
database reply document contains a false C<ok> field or if an exception
occurred during send or receive operations.

Fields:

=over 4

=item *

type: "command_failed"

=item *

commandName: the name of the command being executed

=item *

durationSecs: the elapsed time in seconds since the C<command_started> event.

=item *

failure: a string with a error message about the failure

=item *

eval_error: if an exception occurs, this contains the value of C<$@> when the exception was caught

=item *

reply: a hash reference representing the full database reply or an empty hashref if the failure is due to an exception

=item *

requestId: the request identifier sent to the server

=item *

connectionId: address and port of the destination server

=back

=head2 Server Discovery and Monitoring

These events are fired when servers and topology are amended.

=head3 server_opening_event

This event is sent when a new server is added to the topology.

Fields:

=over 4

=item *

type: "server_opening_event"

=item *

topologyId: The topology refaddr

=item *

address: address of the server

=back

=head3 server_closed_event

This event is sent when a server is removed from the topology.

Fields:

=over 4

=item *

type: "server_closed_event"

=item *

topologyId: The topology refaddr

=item *

address: address of the server

=back

=head3 server_description_changed_event

This event is sent when the server description changes, but does not include
changes to the RTT.

Fields:

=over 4

=item *

type: "server_description_changed_event"

=item *

address: address of the server

=item *

topologyId: The topology refaddr

=item *

previousDescription: Server Description before the change

=item *

newDescription: Server Description after the change

=back

=head3 topology_opening_event

This event is sent when the topology is created.

Fields:

=over 4

=item *

type: "topology_opening_event"

=item *

topologyId: The topology refaddr

=back

=head3 topology_closed_event

This event is sent when the topology is closed.

Fields:

=over 4

=item *

type: "topology_closed_event"

=item *

topologyId: The topology refaddr

=back

=head3 topology_description_changed_event

This event is sent when the topology description changes.

Fields:

=over 4

=item *

type: "topology_description_changed_event"

=item *

topologyId: The topology refaddr

=item *

previousDescription: Topology Description before the change

=item *

newDescription: Topology Description after the change

=back

=head3 server_heartbeat_started_event

This event is sent before the ismaster command is sent to the server.

Fields:

=over 4

=item *

type: "server_heartbeat_started_event"

=item *

connectionId: address of the link to connect to

=back

=head3 server_heartbeat_succeeded_event

This event is sent after the reply from the ismaster command arrives from a
successful reply.

Fields:

=over 4

=item *

type: "server_heartbeat_succeeded_event"

=item *

duration: time it took to send and receive a reply

=item *

reply: the ismaster command reply

=item *

connectionId: address of the server

=back

=head3 server_heartbeat_failed_event

This event is sent if there is a failure from the ismaster command, which returns
an error string of some sort.

Fields:

=over 4

=item *

type: "server_heartbeat_failed_event"

=item *

duration: time it took to send and receive a reply

=item *

failure: Returns an error string of the failure

=item *

connectionId: address of the server

=back

=head1 REDACTION

Certain commands are considered sensitive.  When any of the following
commands are seen in monitoring, the command body and database reply body
are replaced with an empty document:

=over 4

=item *

authenticate

=item *

saslStart

=item *

saslContinue

=item *

getnonce

=item *

createUser

=item *

updateUser

=item *

copydbgetnonce

=item *

copydbsaslstart

=back

=head1 AUTHORS

=over 4

=item *

David Golden <david@mongodb.com>

=item *

Rassi <rassi@mongodb.com>

=item *

Mike Friedman <friedo@friedo.com>

=item *

Kristina Chodorow <k.chodorow@gmail.com>

=item *

Florian Ragwitz <rafl@debian.org>

=back

=head1 COPYRIGHT AND LICENSE

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

=cut

${this.title}

Code Editor : Monitoring.pod