Skip to content

Commit 0906449

Browse files
authored
Merge branch 'main' into berry
2 parents b21627f + 96c5963 commit 0906449

File tree

264 files changed

+3300
-1553
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

264 files changed

+3300
-1553
lines changed

README.md

Lines changed: 64 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -8,36 +8,80 @@
88
<a href="https://help.sumologic.com/release-notes-service"><img src="https://img.shields.io/badge/RSS-FFA500?style=for-the-badge&logo=rss&logoColor=white" alt="RSS Follow" width="50"/></a>
99
</p>
1010

11-
Share your knowledge with the Sumo Logic community by contributing to our docs! You can contribute by creating an issue or pull request (PR) on our GitHub repository. We welcome all types of contributions; from minor typo fixes to new topics.
11+
Sumo Docs is the open-source documentation site for Sumo Logic, an all-in-one cloud data analytics platform built to support security, operations, and business intelligence use cases. Sumo Logic empowers users to monitor, analyze, troubleshoot, and visualize data from their applications and network environments in real time. Its elastic processing capabilities enable seamless log data collection and management from various sources, regardless of type, volume, or location. Learn more at [sumologic.com](https://www.sumologic.com).
1212

13-
Documentation staff members review issues and pull requests on a regular basis. We do our best to address all issues as soon as possible, but working through the backlog takes time. We appreciate your patience.
13+
## Get involved
1414

15-
## Contributing Content
15+
We welcome contributions from the community! Whether it's fixing a typo, adding new content, or proposing improvements, your input helps users make the most of Sumo Logic. You can contribute by creating an issue or submitting a pull request in our GitHub repository.
1616

17-
For detailed instructions, including our style guide, see [Contributor Guidelines](https://help.sumologic.com/docs/contributing).
17+
Here’s how to get started:
18+
- Fork our repo and create a new branch for your content changes.
19+
- Preview your edits by building the site locally.
20+
- Submit a pull request for review.
1821

19-
We recommend forking our repo, creating a new branch for your content changes, and submitting a pull request. We will help review, test, and merge the content for publishing.
22+
Our team will help review, test, and merge your contributions for publishing.
2023

21-
## Building Locally
24+
Sumo Docs is built with [Docusaurus 3](https://docusaurus.io/) and supports React, Rehype, and Remark plugins. We also use [cla-bot](https://colineberhardt.github.io/cla-bot/) to manage our Contributor License Agreement (CLA) process.
2225

23-
Docusaurus requires the following to build on locals:
26+
Before submitting an issue or pull request, we recommend reviewing the sections below.
2427

25-
* [NodeJS](https://nodejs.org/en/download/) version >= 16.14
26-
* [Yarn](https://yarnpkg.com/en/) version >= 1.5, you can install with [Homebrew](https://brew.sh/) if you have that installed: `brew install yarn`
28+
## Table of contents
2729

28-
The site includes translations into other languages. To build on your local:
30+
- [Get involved](#get-involved)
31+
- [Prerequisites](#prerequisites)
32+
- [Installation](#installation)
33+
- [Contributing content](#contributing-content)
34+
- [Building locally](#building-locally)
35+
- [Publishing content](#publishing-content)
2936

30-
1. Clone the repo using Git or tools like GitHub Desktop.
31-
1. In a terminal, change to the cloned repo folder. Run the install command: `yarn install`.
32-
1. To serve and review your content, use one of the following:
33-
* Use start, hot reloads as you make changes: `yarn start`. Any issues with broken links and images are listed according to file. Locate and update those issues, then run build and start again to verify.
34-
* Use npm serve to test and review multi-languages: `npm run serve`. This build does not hot reload and requires a rebuild to test and review.
35-
1. To build locally and test your links, run `yarn build`.
37+
## Prerequisites
3638

37-
The static files are generated in the `build` folder and run on your local machine at: `http://localhost:3000/`. To stop the build or served site, hit Ctrl + C to interrupt. You can enter new commands in terminal, rebuild, and restart.
39+
To contribute to Sumo Docs, ensure you have the following tools installed:
3840

39-
Sumo Docs was created using [Docusaurus 2](https://docusaurus.io/) with React, Rehype, and Remark plugin support. Our CLA bot was built using [cla-bot](https://colineberhardt.github.io/cla-bot/).
41+
- [Node.js](https://nodejs.org/en/download/) version 18 or higher
42+
- [Yarn](https://yarnpkg.com/en/), installable via [Homebrew](https://brew.sh/) (`brew install yarn`)
4043

41-
## Publishing Content
44+
## Installation
4245

43-
As pull requests are merged to the `main` branch by the Sumo Logic Doc team, the content builds and deploys to a staging site. This allows you to review and test your content thoroughly on a server, rather than a local build, prior to merging your code to production.
46+
1. Fork and clone the repository using Git or a tool like GitHub Desktop.
47+
2. Navigate to the cloned repository folder:
48+
```bash
49+
cd sumologic-documentation
50+
```
51+
3. Install dependencies:
52+
```bash
53+
yarn install
54+
```
55+
56+
## Apply your changes
57+
58+
Make edits using [Markdown syntax](https://help.sumologic.com/docs/contributing/style-guide/#markdown). Keep contributions concise, informative, and aligned with our guidelines.
59+
60+
Refer to our [Contributor Guidelines](https://help.sumologic.com/docs/contributing/create-edit-doc/#edit-a-doc) for more information on:
61+
- Markdown editing
62+
- Proposing bug fixes
63+
- Testing your changes
64+
65+
All contributions must follow our [Style Guide](https://help.sumologic.com/docs/contributing/style-guide/).
66+
67+
## Building locally
68+
69+
Building the site locally ensures your changes are accurate and functional before submission.
70+
71+
1. Serve and preview your content with hot reloads:
72+
```bash
73+
yarn start
74+
```
75+
Any issues, such as broken links or images, will be listed. Fix them, rebuild, and verify your changes.
76+
77+
2. Build the site and test locally:
78+
```bash
79+
yarn build
80+
```
81+
The static files will be generated in the `build` folder and served at `http://localhost:3000/`.
82+
83+
To stop the local server or build process, press `Ctrl + C`. You can rebuild and restart as needed.
84+
85+
## Publishing content
86+
87+
Our documentation team regularly reviews issues and pull requests. While we strive to address contributions promptly, there may be delays as we work through the backlog. Your patience is appreciated.

blog-cse/2024-12-06-content.md

Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
title: December 6, 2024 - Content Release
3+
hide_table_of_contents: true
4+
keywords:
5+
- log mappers
6+
- log parsers
7+
- detection rules
8+
- tag schemas
9+
image: https://help.sumologic.com/img/sumo-square.png
10+
---
11+
12+
import useBaseUrl from '@docusaurus/useBaseUrl';
13+
14+
<a href="https://help.sumologic.com/release-notes-cse/rss.xml"><img src={useBaseUrl('img/release-notes/rss-orange2.png')} alt="icon" width="50"/></a>
15+
16+
This content release:
17+
- Introduces new Cloud SIEM detection rules for monitoring activity and alerts from GitHub Enterprise.
18+
- New and updated log parsing and mapping support for:
19+
- AWS VPC Transit Gateways Flow Logs
20+
- Alert Logic
21+
- Google G Suite Alert Center
22+
- Microsoft Defender Advanced Hunting
23+
- Azure Provisioning, Alert, ResourceHealth, and ServiceHealth events
24+
25+
Changes are enumerated below.
26+
27+
:::note
28+
First Seen Successful Authentication From Unexpected Country (FIRST-S00029), which is disabled by default, has been replaced by a rule of the same name (FIRST-S00065) which is enabled by default. FIRST-S00029 will be removed in a subsequent release in 2 weeks (week of December 16). Any tuning expressions applied to FIRST-S00029 will need to be migrated to FIRST-S00065 to continue functioning.
29+
:::
30+
31+
### Rules
32+
- [New] MATCH-S00952 GitHub - Administrator Added or Invited
33+
- Detects additions or invitations of GitHub Administrators. Illegitimate addition of administrative users could be an indication of privilege escalation or persistence by adversaries.
34+
- [New] MATCH-S00953 GitHub - Audit Logging Modification
35+
- Detects modifications to the GitHub Enterprise Audit Log. Modifications and deletions have the potential to reduce visibility of malicious activity.
36+
- [New] MATCH-S00954 GitHub - Copilot Seat Cancelled by GitHub
37+
- Observes for GitHub staff manually revoking copilot access for a user. This action is likely to be rare and may be indicative of a user violating the [acceptable use policy for GitHub](https://docs.github.com/en/site-policy/acceptable-use-policies).
38+
- [New] FIRST-S00091 GitHub - First Seen Activity From Country for User
39+
- Detects GitHub user activity from a new country. User account compromises can be detected through unusual geolocation in some cases. To lower possible false positives, a tuning expression for expected country names or codes can be added,.
40+
- [New] FIRST-S00090 GitHub - First Seen Application Interacting with API
41+
- Detects new application usage of the GitHub API. New applications utilizing the API may be routine, however this may also reveal malicious applications utilizing the API.
42+
- [New] MATCH-S00950 GitHub - Member Invitation or Addition
43+
- Detects new user additions or invitations to the business or organization GitHub. New user additions/invitations should be monitored as they could be a vector for malicious actors to establish access or persistence.
44+
- [New] MATCH-S00955 GitHub - Member Permissions Modification
45+
- Detects modifications of GitHub user permissions. Added permissions for a user should be monitored for potential privilege escalation by an adversary.
46+
- [New] MATCH-S00956 GitHub - OAuth Application Activity
47+
- Detects OAuth application activities within GitHub. OAuth application management and access activity should be monitored for potential abuse by potential malicious actors, either by creating malicious access paths within GitHub, or destruction of GitHub infrastructure.
48+
- [New] MATCH-S00957 GitHub - Organization Transfer
49+
- Detects transfers of an organization to another enterprise This is a sensitive activity that should be monitored to ensure organizations and their repositories are not being transferred without proper authorization.
50+
- [New] OUTLIER-S00026 GitHub - Outlier in Distinct User Agent Strings by User
51+
- Detects an outlier in the number of distinct user agent strings for a GitHub user. Unusual user agent strings for a user account could indicate account takeover.
52+
- [New] OUTLIER-S00028 GitHub - Outlier in Removal Actions by User
53+
- Detects a higher than usual number of removal actions undertaken by a user. This detection has a broad scope to detect any unusual number of destroy, delete, or remove actions undertaken by a user to help detect a range of different potential destructive activities in GitHub.
54+
- [New] OUTLIER-S00027 GitHub - Outlier in Repository Cloning or Downloads
55+
- Detects an unusual number of repository clones for a user. Unusual repository cloning could indicate data exfiltration or discovery.
56+
- [New] MATCH-S00958 GitHub - PR Review Requirement Removed
57+
- Detects GitHub pull request review requirements being removed from a repository either via branch protection rule or ruleset.
58+
- [New] MATCH-S00959 GitHub - Repository Public Key Deletion
59+
- Detects deletions of SSH keys in GitHub. Unusual deletions could represent an adversary attempting to disrupt normal operations by denying access.
60+
- [New] MATCH-S00960 GitHub - Repository Transfer
61+
- Detects transfers of a repository to another organization or user. This is a sensitive activity that GitHub places in the "Danger Zone" of repository setting and should be monitored to ensure no unauthorized transfers are taking place.
62+
- [New] MATCH-S00961 GitHub - Repository Visibility Changed to Public
63+
- Detects a user making a repository public. This action should be closely monitored and mitigative actions taken even if the published repository is deleted, or reverted to private. Reference: https://trufflesecurity.com/blog/anyone-can-access-deleted-and-private-repo-data-github
64+
- [New] MATCH-S00962 GitHub - Repository Visibility Permissions Changed
65+
- Detects repository visibility permissions being changed to allow members of an organization to change the visibility of repositories. This activity introduces the potential for data leakage if a private or internal repository is changed to public and should be monitored to ensure no inadvertent or malicious publication of a repository.
66+
- [New] MATCH-S00963 GitHub - SSH Key Created for Private Repo
67+
- Detects the creation of an SSH key for a private GitHub repository. Performed maliciously, creating an SSH key could create a parallel access path for an attacker.
68+
- [New] MATCH-S00964 GitHub - SSO Recovery Codes Access Activity
69+
- Detects activities accessing SSO recovery codes. SSO recovery codes can enable a user to bypass normal more stringent authentication routes.
70+
- [New] MATCH-S00951 GitHub - Secret Scanning Alert
71+
- Observes for secret scanning alerts from GitHub. Secrets detected by GitHub Enterprise Cloud undergo validation by GitHub automatically, to determine whether they are actively in use, this is not surfaced in the audit log, and will require separate inspection. For more information see [Evaluating alerts from secret scanning](https://docs.github.com/en/code-security/secret-scanning/managing-alerts-from-secret-scanning/evaluating-alerts).
72+
- [New] MATCH-S00965 GitHub - Secret Scanning Potentially Disabled
73+
- Detects actions which disable or modify secret scanning policies for an organization or repository. Modifying or disabling secret scanning may lead to inadvertent leaking of credentials.
74+
- [New] MATCH-S00966 GitHub - Two-Factor Authentication Disabled for Organization
75+
- Observes for two-factor authentication being disabled for a GitHub organization. Removing two-factor authentication requirements significantly degrades the security of the GitHub organization by permitting password only authentication.
76+
- [Updated] THRESHOLD-S00095 Password Attack from Host
77+
- Modified the rule expression to remove the `srcDevice_ip` entity selector and the `isNull` from the rule expression for entities from the existing rule, and creates a new rule for those entities so that there are 2 versions of the rule's intent.
78+
79+
### Log Mappers
80+
- [New] AWS VPC Transit Gateways Flow Logs
81+
- [New] Alert Logic Catch All
82+
- [New] Azure ResourceHealth and ServiceHealth
83+
- [New] Google G Suite Alert Center - User Changes
84+
- [New] Microsoft Defender Advanced Hunting - Alert
85+
- [New] Microsoft Defender Advanced Hunting - Audit
86+
- [New] Microsoft Defender Advanced Hunting - Email events
87+
- [New] Microsoft Defender Advanced Hunting - Logon
88+
- [New] Microsoft Defender Advanced Hunting - Network
89+
- [Updated] Azure Event Hub - Windows Defender Logs and Azure Alert
90+
- Adds support for additional event types and field mappings.
91+
- [Updated] Trend Micro Vision One Custom Parser
92+
- Supports additional field names.
93+
94+
### Parsers
95+
- [New] /Parsers/System/AWS/AWS VPC Transit Gateways Flow Logs
96+
- [New] /Parsers/System/Alert Logic/Alert Logic
97+
- [New] /Parsers/System/Microsoft/Microsoft Defender Advanced Hunting
98+
- [Updated] /Parsers/System/Trend Micro/Trend Micro Vision One
99+
- Parser updated to support additional event format.

blog-service/2023/12-31.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -686,7 +686,7 @@ We've increased the maximum number of time series processed by a single aggregat
686686

687687
#### Account Page Improvements
688688

689-
We've enhanced our [**Account** page](/docs/manage/manage-subscription/sumo-logic-credits-accounts/#viewing-the-account-information) to make it easier for you to understand how your credits are being allocated. With **Details of Credit Usage**, you can separate out your ingest, storage, and scan credit burn rates as **Promotional Credits** covers any promotional credits you are using with the account. You can also filter your view by day, week, and month, or view by time period. And you can download these reports as a CSV.
689+
We've enhanced our [**Account Overview** page](/docs/manage/manage-subscription/sumo-logic-credits-accounts/#account-overview) to make it easier for you to understand how your credits are being allocated. With **Details of Credit Usage**, you can separate out your ingest, storage, and scan credit burn rates as **Promotional Credits** covers any promotional credits you are using with the account. You can also filter your view by day, week, and month, or view by time period. And you can download these reports as a CSV.
690690

691691

692692
---
@@ -1327,7 +1327,7 @@ Multiple metrics queries can be defined from scratch on the SLO editor and the m
13271327

13281328
#### Metrics Monitors Enhancements
13291329

1330-
Update - We've enhanced the alerting logic for Metrics Monitors to ensure more accurate alerts. For monitors that alert when all data points are above a given threshold `at all times within`, we've added a customizable parameter for the minimum number of required data points within an alerting window. And, for any existing monitor, the default setting is 2, which means that two data points are required within an alerting window to generate an alert. [Learn more](/docs/alerts/monitors/create-monitor/#alert-and-recovery-window).
1330+
Update - We've enhanced the alerting logic for Metrics Monitors to ensure more accurate alerts. For monitors that alert when all data points are above a given threshold `at all times within`, we've added a customizable parameter for the minimum number of required data points within an alerting window. And, for any existing monitor, the default setting is 2, which means that two data points are required within an alerting window to generate an alert. [Learn more](/docs/alerts/monitors/create-monitor/#static-detection-method-1).
13311331

13321332

13331333
---

blog-service/2024-03-04-manage.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
1212

1313
<a href="https://help.sumologic.com/release-notes-service/rss.xml"><img src={useBaseUrl('img/release-notes/rss-orange2.png')} alt="icon" width="50"/></a>
1414

15-
New - We're happy to introduce you to new accounts page enhancements such as Dynamic Forecasts, Credit Baseline, Total Credits Usage Breakdown, Time Series View, and Usage % Change. [Learn more](/docs/manage/manage-subscription/sumo-logic-flex-accounts/#account-page).
15+
New - We're happy to introduce you to new accounts page enhancements such as Dynamic Forecasts, Credit Baseline, Total Credits Usage Breakdown, Time Series View, and Usage % Change. [Learn more](/docs/manage/manage-subscription/sumo-logic-flex-accounts/#account-overview).

blog-service/2024-11-28-apps.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,10 +33,6 @@ We're excited to announce the release of the enhancements listed below for the S
3333
- **Added CloudTrail Audit dashboard**. The CloudTrail Audit dashboard is added to the [AWS Application Load Balancer](/docs/integrations/amazon-aws/application-load-balancer/#cloudtrail-audit), [AWS Classic Load Balancer](/docs/integrations/amazon-aws/classic-load-balancer/#cloudtrail-audit), and [AWS Network Load Balancer](/docs/integrations/amazon-aws/network-load-balancer/#cloudtrail-audit) apps. This dashboard helps you to visualize the successful and failed events globally, event trends, error details, and user activities, offering insights into load balancer performance, security, and usage patterns.
3434
- **Amazon RDS**. Added **Oracle Logs - Alert Logs Analysis**, **Oracle Logs - Audit Logs Analysis**, and **Oracle Logs - Listener Troubleshooting** dashboards. These CloudTrail and CloudWatch Logs dashboard provide monitoring for error logs and essential infrastructure details. [Learn more](/docs/integrations/amazon-aws/rds/#oracle-logs---alert-logs-analysis).
3535
- **MongoDB Atlas**. New version of the [MongoDB Atlas collection](/docs/integrations/databases/mongodb-atlas/#collecting-logs-and-metrics-for-the-mongodb-atlas-app) was released with `v.1.0.11` in [Pypi](https://pypi.org/project/sumologic-mongodb-atlas/) and `v1.0.18` in [AWS Serverless Repository](https://serverlessrepo.aws.amazon.com/applications/us-east-1/956882708938/sumologic-mongodb-atlas). [Learn more](https://github.com/SumoLogic/sumologic-mongodb-atlas/releases/tag/v2.0.1)
36-
- Source Template enhancements:
37-
- Updated log and metric section feature on 11 Source templates (OTRM).
38-
- Updated and maintained the UI uniformity across all Source templates.
39-
- Released masking feature for the Windows Source Template. [Learn more](/docs/send-data/opentelemetry-collector/data-transformations/#masking-examples).
4036

4137
### Bug fixes
4238

0 commit comments

Comments
 (0)