Skip to content

docs(1672): initial hosted runner and mimecast plugin docs#1827

Draft
nic-osullivan-gravwell wants to merge 7 commits intogravwell:next-minorfrom
nic-osullivan-gravwell:hosted-runner-docs
Draft

docs(1672): initial hosted runner and mimecast plugin docs#1827
nic-osullivan-gravwell wants to merge 7 commits intogravwell:next-minorfrom
nic-osullivan-gravwell:hosted-runner-docs

Conversation

@nic-osullivan-gravwell
Copy link
Copy Markdown
Contributor

@nic-osullivan-gravwell nic-osullivan-gravwell commented Mar 27, 2026

This PR addresses https://github.com/gravwell/issues/issues/1672

This PR proposes...

Adding docs for the new hosted runner and mimecast plugin.

PR Tasks

  • e2e and/or unit tests included. If not, please provide an explanation.
  • Bug fixes only: minimal repro steps included on the issue (for PR QA + Release QA).
  • Document Okta plugin as well

Reviewer Tasks

  • e2e or unit tests are present to test the proposed changes.
  • Code is sufficiently documented.
  • Code meets quality and correctness expectations.

(hosted_runner_configuration)=
## Hosted Runner Configuration

The Hosted Runner is a shared process can run a number of different plugins. Rather than deploying a separate service for each integration, all hosted plugins are configured in a single file — typically `/opt/gravwell/etc/hosted_runner.conf` — and run together under one process. This reduces the infrastructure cost of lighter weight processes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The config file is still hosted_ingesters.conf in code, but that will be updated before release.

Copy link
Copy Markdown
Contributor

@ashnwade ashnwade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

First pass at a review. Overall, it is looking really good. Mostly small nits.

| `Client-Secret` | String | | **Yes** | OAuth 2.0 client secret from your Mimecast API 2.0 integration. |
| `Api` | String | | **Yes** | The Mimecast API to poll. Can be specified multiple times. See [Available APIs](#available-apis). |
| `Host` | URL | `https://api.services.mimecast.com` | No | The Mimecast API base URL. Override for regional endpoints or testing. |
| `Lookback` | Integer (hours) | `24` | No | How far back in time to fetch events on first run. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any limit to how far back they can go?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah the batch api has a 7 day limit and the non batch has a 24hour limit. I'll update the docs once we land on which we're using.

@@ -0,0 +1,13 @@
services:
Copy link
Copy Markdown
Contributor

@ashnwade ashnwade Mar 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not really sure why we need this?
this seems pretty trivial to do with the README instructions in this repo

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had issues with nix-shell on my mac and this is what I fell back to and was helpful so figured I'd just add it for others to use if desired.

@ashnwade ashnwade added this to the next-minor milestone Mar 27, 2026
Copy link
Copy Markdown
Contributor

@ashnwade ashnwade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you look at other ingester pages for consistency, it looks like they are not wrapping the parameters in backticks when listing them in tables. PTAL at similar pages for style consistency.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants