Merge branch 'main' into macro-operator-docs

Author: JV0812

.clabot

@@ -168,7 +168,12 @@
     "lol3909",
     "Hellfire4959",
     "antonymartinsumo",
-    "amee-sumo"
+    "amee-sumo",
+    "chetanchoudhary-sumo",
+    "JamoCA",
+    "darshan-sumo",
+    "mahendrak-sumo",
+    "chvik"
   ],
   "message": "Thank you for your contribution! As this is an open source project, we require contributors to sign our Contributor License Agreement and do not have yours on file. To proceed with your PR, please [sign your name here](https://forms.gle/YgLddrckeJaCdZYA6) and we will add you to our approved list of contributors.",
   "label": "cla-signed",

README.md

@@ -8,36 +8,80 @@
   <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>
 </p>
 
-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.
+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).
 
-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.
+## Get involved
 
-## Contributing Content
+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.
 
-For detailed instructions, including our style guide, see [Contributor Guidelines](https://help.sumologic.com/docs/contributing).
+Here’s how to get started:
+- Fork our repo and create a new branch for your content changes.
+- Preview your edits by building the site locally.
+- Submit a pull request for review.
 
-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.
+Our team will help review, test, and merge your contributions for publishing.
 
-## Building Locally
+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.
 
-Docusaurus requires the following to build on locals:
+Before submitting an issue or pull request, we recommend reviewing the sections below.
 
-* [NodeJS](https://nodejs.org/en/download/) version >= 16.14
-* [Yarn](https://yarnpkg.com/en/) version >= 1.5, you can install with [Homebrew](https://brew.sh/) if you have that installed: `brew install yarn`
+## Table of contents
 
-The site includes translations into other languages. To build on your local:
+- [Get involved](#get-involved)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Contributing content](#contributing-content)
+- [Building locally](#building-locally)
+- [Publishing content](#publishing-content)
 
-1. Clone the repo using Git or tools like GitHub Desktop.
-1. In a terminal, change to the cloned repo folder. Run the install command: `yarn install`.
-1. To serve and review your content, use one of the following:
-   * 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.
-   * 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.
-1. To build locally and test your links, run `yarn build`.   
+## Prerequisites
 
-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.
+To contribute to Sumo Docs, ensure you have the following tools installed:
 
-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/).
+- [Node.js](https://nodejs.org/en/download/) version 18 or higher
+- [Yarn](https://yarnpkg.com/en/), installable via [Homebrew](https://brew.sh/) (`brew install yarn`)
 
-## Publishing Content
+## Installation
 
-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.
+1. Fork and clone the repository using Git or a tool like GitHub Desktop.
+2. Navigate to the cloned repository folder:
+   ```bash
+   cd sumologic-documentation
+   ```
+3. Install dependencies:
+   ```bash
+   yarn install
+   ```
+
+## Apply your changes
+
+Make edits using [Markdown syntax](https://help.sumologic.com/docs/contributing/style-guide/#markdown). Keep contributions concise, informative, and aligned with our guidelines.
+
+Refer to our [Contributor Guidelines](https://help.sumologic.com/docs/contributing/create-edit-doc/#edit-a-doc) for more information on:
+- Markdown editing
+- Proposing bug fixes
+- Testing your changes
+
+All contributions must follow our [Style Guide](https://help.sumologic.com/docs/contributing/style-guide/).
+
+## Building locally
+
+Building the site locally ensures your changes are accurate and functional before submission.
+
+1. Serve and preview your content with hot reloads:
+   ```bash
+   yarn start
+   ```
+   Any issues, such as broken links or images, will be listed. Fix them, rebuild, and verify your changes.
+
+2. Build the site and test locally:
+   ```bash
+   yarn build
+   ```
+   The static files will be generated in the `build` folder and served at `http://localhost:3000/`.
+
+To stop the local server or build process, press `Ctrl + C`. You can rebuild and restart as needed.
+
+## Publishing content
+
+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-collector/2024-01-25.md

@@ -0,0 +1,108 @@
+---
+title: 2024 Archive
+image: https://help.sumologic.com/img/sumo-square.png
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<a href="https://help.sumologic.com/release-notes-collector/rss.xml"><img src={useBaseUrl('img/release-notes/rss-orange2.png')} alt="icon" width="50"/></a>
+
+This is an archive of 2024 Collector Release Notes. To view the full archive, [click here](/release-notes-collector/archive).
+
+<!--truncate-->
+
+---
+
+### November 26, 2024 - Version 19.516-1
+
+In this release, we've enhanced the security and stability of the Collector with added support for security patches.
+		
+#### Security Fixes
+		
+- Upgraded `Tanuki version` to version 3.5.60 to fix the collector intermittently crashing issue.
+- Upgraded collector JRE to **Amazon Corretto Version 8.432.06.1**.
+		
+#### Troubleshooting
+		
+When upgrading this collector version, the collector running as a non-root user (run as mode) or on a Mac operating system cannot be upgraded through the API/Web UI. To resolve these issue, follow the respective steps below:
+	- **Collector running as a non-root user.** An error message will be displayed indicating that the upgrade is not possible. The upgrade must be performed manually on your machine. Refer to [Upgrade Collectors in Sumo Logic](/docs/send-data/collection/upgrade-collectors/#upgrade-collectors-using-the-command-line) to upgrade the collector manually.
+	- **Collector running on Mac.** The process will stop while upgrading, and the collector will need to be restarted manually on your machine. Use the code below to restart manually.
+        ```
+        sudo ./collector start
+        ```
+
+### October 31, 2024 - Version 19.514-1
+
+In this release, we've enhanced the security and stability of the Collector with added support for security patches and bug fixes.
+
+#### Security Fixes
+
+- Upgraded `com.fasterxml.jackson.core` to version 2.15.4 to address jackson-core vulnerability (CVE-2023-0067).
+- Upgraded `org.apache.avro:avro` to version 1.11.4 to address ion-java vulnerability (CVE-2024-47561).
+
+#### Bug Fix
+
+- Fixed the intermittent collector crash issue for AD source.
+
+### August 23, 2024 - Version 19.506-1
+
+In this release, we've enhanced the security and stability of the Collector with added support for security patches and bug fixes.
+
+#### Security Fixes
+
+- Upgraded collector JRE to **Amazon Corretto Version 8.422.05.1**.
+- Upgraded `com.amazonaws:aws-java-sdk-s3` to version 1.12.767 to address ion-java vulnerability (CVE-2024-21634).
+
+#### Bug Fix
+
+- Fixed the Docker duplication data re-ingestion issue.
+
+### July 03, 2024 - Version 19.500-2
+
+In this release, we've enhanced the security and stability of the Collector with added support for security patches and bug fixes.
+
+#### Security Fixes
+
+- Upgraded collector JRE to **Amazon Corretto Version 8.412.08.1**.
+- Upgraded `Install4j` to version 10 for macOS.
+- Upgraded `com.tanuki:wrapper` to version 3.5.56.
+- Upgraded `org.apache.commons:commons-configuration2` to version 2.11.0 to address known security vulnerabilities (CVE-2024-29133 and CVE-2024-29131).
+- Upgraded `org.bouncycastle:bc-fips` to version 1.2.5.0 to address known security vulnerabilities (CVE-2024-29857).
+- Upgraded `org.apache.commons:commons-compress` to version 1.26.1 to address known security vulnerabilities (CVE-2024-26308 and CVE-2024-25710).
+- Upgraded `org.bouncycastle:bctls-fips` to version 1.0.19 to address known security vulnerabilities (CVE-2024-30171).
+- Upgraded `org.bouncycastle:bcpkix-jdk18on` to version 1.78 to address known security vulnerabilities (CVE-2024-30172, CVE-2024-30171, and CVE-2024-29857).
+- Known issues when upgrading to this version:
+  - **Collector running as non-root user**. Collector running as non-root user (run as mode) cannot be upgraded through the API/Web UI. It display an error message indicating that the upgrade is not possible. The upgrade must be performed manually on your machine. Follow the [steps to upgrade manually](/docs/send-data/collection/upgrade-collectors/#upgrade-collectors-using-the-command-line).
+  - **Collector running on Mac**. Collector running on a Mac operating system cannot be upgraded through the API/Web UI. The process will stop, and the collector will need to be restarted manually on your machine if upgraded using API or Web UI. Use the below code to manually restart.
+    ```
+    sudo ./collector start
+    ```
+
+#### Bug Fix
+
+- Fixed the collector start issue by cleaning the temporary files on Windows.
+- Fixed the issue with starting the collector on Linux RHEL OS (version 8.3 and above) with OS-level FIPS mode enabled.
+
+### March 18, 2024 - Version 19.484-2
+
+In this release, we've upgraded the collector JRE to **Amazon Corretto Version 8.402.08.1** to enhance stability and optimize performance for faster execution.
+
+### March 07, 2024 - Version 19.484-1
+
+In this release, we've enhanced the **Amazon Corretto** back-end support for minor version updates.
+
+### January 25, 2024 - Version 19.478-2
+
+In this release, we've enhanced the security and stability of the Collector with added support for security patches and bug fixes.
+
+#### Security Fixes
+
+- Upgraded collector JRE to **Amazon Corretto Version 8.402.06.1**.
+- Upgraded `Install4j` to version 10.0.6 for Linux arch.
+- Upgraded `org.json:json` to version 20231013 to address known security vulnerabilities (CVE-2023-5072).
+- Upgraded `org.apache.avro:avro` to 1.11.3 to address known security vulnerabilities (CVE-2023-39410).
+- Upgraded `bcprov-jdk15on` to `bcprov-jdk18on` to address known security vulnerabilities (CVE-2023-33201).
+
+#### Bug Fix
+
+- Fixed the issue with Docker Stats Source that was causing metrics to be missing in particular cases.