Skip to content

Commit aab8045

Browse files
authored
Updates auditing and logging page with Ian's changes (#58)
1 parent abff7c4 commit aab8045

File tree

1 file changed

+20
-14
lines changed

1 file changed

+20
-14
lines changed

source/auditing-logging.txt

Lines changed: 20 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -37,45 +37,48 @@ multiple users. As a |service| administrator, you can:
3737
- source IP addresses
3838
- timestamps for successful and failed attempts
3939

40-
- Configure a JSON-formatted audit filter to customize MongoDB auditing
40+
- :atlas:`Configure a JSON-formatted audit filter
41+
</database-auditing/#configure-a-custom-auditing-filter>` to
42+
customize MongoDB auditing
4143
and select the actions, database users, |service| roles, and |ldap| groups
4244
that you want to audit. If you create a custom audit filter, you can
4345
skip using the managed {+atlas-ui+} auditing filter builder and configure
44-
your own tailored filter of event auditing.
46+
your own tailored filter of event auditing. For a full list of
47+
events you can configure for auditing, and for a list of examples,
48+
see :manual:`MongoDB auditing </core/auditing>` and :atlas:`Example Auditing Filters
49+
</database-auditing/#example-auditing-filters>`.
4550

4651
You can :manual:`configure manual auditing </core/auditing>` of most of the
4752
documented :manual:`system event actions </reference/audit-message/mongo/>`
4853
in |service|. Granular MongoDB database auditing allows you to track
4954
usage of all DDL (Data Definition Language), DML (Data Manipulation Language),
50-
and DCL (Data Control Language) commands in detail. For a full list of
51-
events you can configure for auditing, and for a list of examples,
52-
see :manual:`MongoDB auditing </core/auditing>`. See also
55+
and DCL (Data Control Language) commands in detail. See also
5356
:atlas:`Set up Database Auditing </database-auditing>`.
5457

55-
- :atlas:`Audit the actions of temporary database users </production-notes/#audit-temporary-database-users>`.
56-
5758
.. _accessing-audit-logs:
5859

5960
Accessing Audit Logs
6061
````````````````````
6162

6263
.. include:: /includes/cloud-docs/logs.rst
6364

64-
To return and update your audit configuration per project, use the following
65-
`Atlas Administration API <https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/>`__ commands:
65+
To return and update your audit configuration per project, use the following {+atlas-cli+} commands:
6666

67-
- :ref:`atlas-auditing-describe <atlas-auditing-describe>` returns the
67+
- :ref:`atlas auditing describe <atlas-auditing-describe>` returns the
6868
auditing configuration for the specified project.
69-
- :ref:`atlas-auditing-update <atlas-auditing-update>` updates
69+
- :ref:`atlas auditing update <atlas-auditing-update>` updates
7070
the auditing configuration for the specified project.
7171

7272
You can :ref:`view authentication attempts <access-tracking>` that users
73-
make against your {+cluster+}. |service| logs both successful and unsuccessful
73+
make against your {+cluster+} with the {+atlas-cli+},
74+
{+atlas-admin-api+}, or {+atlas-ui+}. |service| logs both successful and unsuccessful
7475
authentication attempts, including the timestamp of each attempt and which
7576
user tried to authenticate.
7677

77-
You can :ref:`view and filter the activity feed <view-activity-feed>`
78-
for an organization or project.
78+
You can also :ref:`view and filter the activity feed <view-activity-feed>`
79+
for an organization or project with the {+atlas-cli+},
80+
{+atlas-admin-api+}, or {+atlas-ui+}. The activity feed lists all
81+
events at the organization or project level
7982

8083
To perform a full audit, you can use a combination of audit logs,
8184
the ``mongodb.log``, and :ref:`the project activity feed <view-activity-feed>`.
@@ -89,6 +92,9 @@ To optimize costs, you can disable auditing in lower environments for developmen
8992
Certain industries, like healthcare and financial services, may opt to keep
9093
auditing enabled in development for compliance reasons.
9194

95+
Enabling auditing for all database users, including application
96+
service users, might affect cluster performance. We recommend that you audit only the actions of users that require auditing.
97+
9298
For staging and production environments, enable auditing for
9399
additional security. We recommend that you audit the following events at a minimum:
94100

0 commit comments

Comments
 (0)