Skip to content

Commit d274dcd

Browse files
authored
(DOCSP-45941) Revises per explicit edits from v1 review. (#56)
1 parent 0748d9f commit d274dcd

File tree

2 files changed

+17
-13
lines changed

2 files changed

+17
-13
lines changed

source/auditing-logging.txt

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,8 @@ Features
2525
Auditing
2626
````````
2727

28-
Database auditing lets you track system activity for deployments with
28+
Available on ``M10+`` {+clusters+}, database auditing lets you track system
29+
activity for deployments with
2930
multiple users. As a |service| administrator, you can:
3031

3132
- Rely on default auditing settings in |service|. By default, |service|
@@ -60,9 +61,8 @@ Accessing Audit Logs
6061

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

63-
To retrieve the audit logs using the {+atlas-admin-api+}, see
64-
:oas-atlas-op:`Logs </downloadLogsForOneClusterHostInOneProject>`. You
65-
can use these API commands:
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:
6666

6767
- :ref:`atlas-auditing-describe <atlas-auditing-describe>` returns the
6868
auditing configuration for the specified project.
@@ -83,8 +83,11 @@ the ``mongodb.log``, and :ref:`the project activity feed <view-activity-feed>`.
8383
Recommendations for Auditing
8484
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
8585

86-
For development and testing environments, do not enable auditing. This
87-
saves costs in your non-production environments.
86+
We recommend that you enable auditing when you provision your {+clusters+}.
87+
However, auditing puts additional load on your {+clusters+} and increases costs.
88+
To optimize costs, you can disable auditing in lower environments for development.
89+
Certain industries, like healthcare and financial services, may opt to keep
90+
auditing enabled in development for compliance reasons.
8891

8992
For staging and production environments, enable auditing for
9093
additional security. We recommend that you audit the following events at a minimum:
@@ -126,15 +129,15 @@ Recommendations for Audit Logs
126129
To integrate with tools beyond the built-in integrations, we recommend
127130
that you retrieve logs with the following tools and feed the JSON-formatted output to your external tools:
128131

132+
- If you use |aws|, you can continually push logs to an |aws| S3
133+
bucket. To learn more, see the
134+
:oas-atlas-tag:`Push-Based Log Export <Push-Based-Log-Export>` {+atlas-admin-api+} endpoints.
135+
- Use the {+atlas-admin-api+} endpoints for :oas-atlas-tag:`Logs <MongoDB-Cloud-Users>` and :oas-atlas-tag:`Project Events <Events>` to
136+
retrieve deployment logs and lists of project events.
129137
- Use the ``atlas deployments logs`` command in the {+atlas-cli+}
130138
to retrieve deployment logs. To learn more,
131139
see :atlas:`Atlas Deployment Logs
132140
</cli/current/command/atlas-deployments-logs/>`.
133-
- Use the {+atlas-admin-api+} endpoints for :oas-atlas-tag:`Logs <MongoDB-Cloud-Users>` and :oas-atlas-tag:`Project Events <Events>` to
134-
retrieve deployment logs and lists of project events.
135-
- If you use |aws|, you can continually push logs to an |aws| S3
136-
bucket. To learn more, see the
137-
:oas-atlas-tag:`Push-Based Log Export <Push-Based-Log-Export>` {+atlas-admin-api+} endpoints.
138141

139142
Examples
140143
--------

source/includes/cloud-docs/logs.rst

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
1+
|service| retains the last 30 days of log messages and
2+
system event audit messages.
13
You can download |service| logs at any point until the end of their
24
retention periods by using the {+atlas-ui+}, {+atlas-admin-api+}, and
3-
{+atlas-cli+}. |service| retains the last 30 days of log messages and
4-
system event audit messages.
5+
{+atlas-cli+}.
56

67
To learn more, see :ref:`mongodb-logs`.

0 commit comments

Comments
 (0)