add apps and others manually to ingest options script

Author: dasfmi

guides/apex.mdx

@@ -0,0 +1,9 @@
+---
+title: 'Axiom Go Adapter for apex/log'
+description: 'Adapter to ship logs generated by apex/log to Axiom.'
+overview: 'Minimalistic logging library for Go'
+sidebarTitle: 'Apex'
+url: 'https://pkg.go.dev/github.com/axiomhq/axiom-go/adapters/apex'
+tags: ['go', 'golang', 'apex']
+logoId: 'apex'
+---

guides/logrus.mdx

@@ -0,0 +1,9 @@
+---
+title: 'Axiom Go Adapter for sirupsen/logrus'
+description: 'Adapter to ship logs generated by sirupsen/logrus to Axiom.'
+overview: 'Structured logger for Go'
+sidebarTitle: 'Logrus'
+url: 'https://pkg.go.dev/github.com/axiomhq/axiom-go/adapters/logrus'
+tags: ['go', 'golang', 'logrus']
+logoId: 'logrus'
+---

guides/pino.mdx

@@ -1,8 +1,10 @@
 ---
 title: 'Axiom transport for Pino logger'
 description: 'This page explains how to send data from a Node.js app to Axiom through Pino.'
+overview: 'Fast JSON logger for Node.js'
 sidebarTitle: Pino
 tags: ['js', 'pino', 'winston', 'node', 'javascript', 'typescript', 'ts']
+logoId: 'pino'
 ---
 
 import Prerequisites from "/snippets/standard-prerequisites.mdx"
@@ -44,4 +46,4 @@ logger.info('Hello from Pino!');
 
 ## Examples
 
-For more examples, see the [examples in GitHub](https://github.com/axiomhq/axiom-js/tree/main/examples/pino).
+For more examples, see the [examples in GitHub](https://github.com/axiomhq/axiom-js/tree/main/examples/pino).

guides/winston.mdx

@@ -1,8 +1,10 @@
 ---
 title: 'Axiom transport for Winston logger'
 description: 'This page explains how to send data from a Node.js app to Axiom through Winston.'
+overview: 'A logger for just about everything'
 sidebarTitle: Winston
 tags: ['js', 'pino', 'winston', 'node', 'javascript', 'typescript', 'ts']
+logoId: 'winston'
 ---
 
 import Prerequisites from "/snippets/standard-prerequisites.mdx"

guides/zap.mdx

@@ -0,0 +1,9 @@
+---
+title: 'Axiom adapter for Zap logger'
+description: 'Adapter to ship logs generated by uber-go/zap to Axiom.'
+overview: 'Blazing fast, structured, leveled logging in Go'
+sidebarTitle: 'Zap'
+url: 'https://pkg.go.dev/github.com/axiomhq/axiom-go/adapters/zap'
+tags: ['go', 'golang', 'zap']
+logoId: 'zap'
+---

ingest-options.json

@@ -124,6 +124,9 @@
             "guides/opentelemetry-django",
             "guides/go",
             "guides/opentelemetry-go",
+            "guides/apex",
+            "guides/logrus",
+            "guides/zap",
             "guides/opentelemetry-java",
             "guides/javascript",
             "guides/send-logs-from-laravel",
@@ -202,10 +205,7 @@
         {
           "group": "Monitors",
           "icon": "desktop",
-          "pages": [
-            "monitor-data/monitors",
-            "monitor-data/pagerduty"
-          ]
+          "pages": ["monitor-data/monitors", "monitor-data/pagerduty"]
         }
       ]
     },
@@ -278,10 +278,7 @@
     },
     {
       "group": "Get Started",
-      "pages": [
-        "apl/introduction",
-        "apl/tutorial"
-      ]
+      "pages": ["apl/introduction", "apl/tutorial"]
     },
     {
       "group": "Functions",
@@ -418,9 +415,7 @@
     },
     {
       "group": "User Endpoints",
-      "pages": [
-        "restapi/endpoints/getCurrentUser"
-      ]
+      "pages": ["restapi/endpoints/getCurrentUser"]
     },
     {
       "group": "Dataset Endpoints",

mint.json

@@ -1,8 +1,12 @@
 ---
 title: 'Axiom CLI'
+sidebarTitle: 'CLI'
 description: 'Learn how to use the Axiom CLI to ingest data, manage authentication state, and configure multiple deployments.'
+overview: 'Command-line interface for interacting with Axiom programmatically'
 tags:
-  ['axiom documentation', 'documentation', 'axiom', 'reference', 'settings', 'field restrictions', 'libraries', 'cli', 'axiom cli']
+  ['terminal', 'shell', 'axiom documentation', 'documentation', 'axiom', 'reference', 'settings', 'field restrictions', 'libraries', 'cli', 'axiom cli']
+logoId: 'cli'
+darkLogoId: 'clidark'
 ---
 
 Axiom’s command line interface (CLI) is an Axiom tool that lets you test, manage, and build your Axiom projects by typing commands on the command-line.
@@ -78,7 +82,7 @@ To view available environment variables, run `axiom help environment` for an up
 AXIOM_DEPLOYMENT: The deployment to use. Overwrites the choice loaded
 from the configuration file.
 
-AXIOM_ORG_ID: The organization ID of the organization the access 
+AXIOM_ORG_ID: The organization ID of the organization the access
 token is valid for.
 
 AXIOM_PAGER, PAGER (in order of precedence): A terminal paging
@@ -90,15 +94,15 @@ loaded from the configuration file.
 AXIOM_URL: The deployment url to use. Overwrites the choice loaded
 from the configuration file.
 
-VISUAL, EDITOR (in order of precedence): The editor to use for 
+VISUAL, EDITOR (in order of precedence): The editor to use for
 authoring text.
 
 NO_COLOR: Set to any value to avoid printing ANSI escape sequences
 for color output.
 
 CLICOLOR: Set to "0" to disable printing ANSI colors in output.
 
-CLICOLOR_FORCE: Set to a value other than "0" to keep ANSI colors in 
+CLICOLOR_FORCE: Set to a value other than "0" to keep ANSI colors in
 output even when the output is piped.
 ```
 

reference/cli.mdx

@@ -1,9 +1,12 @@
 ---
 title: 'Get Started with Axiom API'
 description: 'Learn how to ingest structured data logs, handle queries, and manage your deployments using the API.'
+overview: 'Standard interface for HTTP-based application programming'
 sidebarTitle: Introduction
 tags:
     ['axiom documentation', 'documentation', 'axiom', 'axiom api', 'rest api', 'rest', 'content type', 'datasets', 'authentication', 'string', 'boolean', 'integer', 'float', 'map', 'list']
+logoId: 'http'
+enlargeLogo: true
 ---
 
 Axiom understands your resources and provides an API to ingest structured data logs, handle queries, and manage your deployments. This REST-style API uses JSON for serialization and gives you complete control over the entire Axiom platform.

restapi/introduction.mdx

@@ -4,7 +4,25 @@ import YAML from "yaml";
 const generateList = async () => {
   const data = await readFile("mint.json", "utf-8");
   const mint = JSON.parse(data);
-  const groups = mint.navigation[1].pages.filter((p) => p.group);
+  // get the collectors, technologies and any send-data method but also include integrations
+  let groups = mint.navigation[1].pages.filter((p) => p.group);
+  // unfortunately the integration group has other stuff than sending data
+  // so we need to filter it out.
+  groups.push({
+    group: "Apps & Integraitons",
+    pages: [
+      "apps/cloudflare-logpush",
+      "apps/netlify",
+      "apps/tailscale",
+      "apps/vercel",
+    ],
+  });
+  // the API and CLI group is not included in the navigation
+  // so we need to add it manually
+  groups.push({
+    group: "Other",
+    pages: ["restapi/introduction", "reference/cli"],
+  });
 
   const options = await Promise.all(
     groups.map(async (group) => {
@@ -18,6 +36,9 @@ const generateList = async () => {
     }),
   );
 
+  // overide rest api name to be more descriptive
+  options[options.length - 1][0].name = "REST API";
+
   return options.flat();
 };
 
@@ -26,6 +47,11 @@ const parsePageInfo = async (path, group) => {
   // capture frontmatter header only
   const text = f.match(/---([\s\S]*?)---/)[0];
   const data = YAML.parse(text.replaceAll("---", ""));
+
+  // rename sidebarTitle to name
+  data.name = data.sidebarTitle;
+  delete data.sidebarTitle;
+
   return {
     group,
     url: `https://axiom.co/docs/${path}`,
@@ -35,16 +61,30 @@ const parsePageInfo = async (path, group) => {
 
 const main = async () => {
   const ingestOptions = await generateList();
-  console.log(ingestOptions);
+  console.log(
+    `found ${ingestOptions.length} ingest options categorized as follows:`,
+  );
+  // print stats
+  const stats = {};
+  for (const opt of ingestOptions) {
+    if (stats[opt.group]) {
+      stats[opt.group] += 1;
+    } else {
+      stats[opt.group] = 1;
+    }
+  }
+  for (const key of Object.keys(stats)) {
+    console.log(`\t${key}: ${stats[key]} options`);
+  }
 
+  console.log("------");
   console.log("writing result to file...");
   await writeFile(
     "ingest-options.json",
     JSON.stringify(ingestOptions),
     "utf-8",
   );
-  console.log("result written to => ingest-options.json");
-  console.log("done");
+  console.log("done, result written to => ingest-options.json");
 };
 
 await main();

scripts/generate-ingest-options.mjs

@@ -1,8 +1,10 @@
 ---
 title: 'Send data from Datadog to Axiom'
 description: 'Send data from Datadog to Axiom.'
+overview: 'Send data from Datadog to Axiom.'
 sidebarTitle: Datadog
 tags: ['axiom documentation', 'documentation', 'axiom', 'endpoints', 'http', 'syslog', 'splunk', 'datadog', 'loki', 'honeycomb', 'javascript', 'python']
+logoId: 'datadog'
 ---
 
 Sending data from Datadog to Axiom is a private preview feature available upon request.
@@ -11,4 +13,4 @@ Please [contact Axiom](https://axiom.co/migrations/datadog) to learn more about
 
 <Note>
 You can only send logs from Datadog to Axiom. Support for metrics is coming soon.
-</Note>
+</Note>