{"record":{"id":"2766b14dccd5e64d","repo":"slimtoolkit/slim","slug":"unknown-sensor-mode","errorCode":null,"errorMessage":"unknown sensor mode","messagePattern":"unknown sensor mode","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pkg/app/sensor/app.go","lineNumber":97,"sourceCode":"\tenableMondelFlagUsage   = \"enable monitor data event logging\"\n\tenableMondelFlagDefault = false\n)\n\nvar (\n\tgetAppBom            *bool          = flag.Bool(\"appbom\", getAppBomFlagDefault, getAppBomFlagUsage)\n\tenableDebug          *bool          = flag.Bool(\"debug\", enableDebugFlagDefault, enableDebugFlagUsage)\n\tlogLevel             *string        = flag.String(\"log-level\", logLevelFlagDefault, logLevelFlagUsage)\n\tlogFormat            *string        = flag.String(\"log-format\", logFormatFlagDefault, logFormatFlagUsage)\n\tlogFile              *string        = flag.String(\"log-file\", logFileFlagDefault, logFileFlagUsage)\n\tsensorMode           *string        = flag.String(\"mode\", sensorModeFlagDefault, sensorModeFlagUsage)\n\tcommandsFile         *string        = flag.String(\"command-file\", commandsFileFlagDefault, commandsFileFlagUsage)\n\tartifactsDir         *string        = flag.String(\"artifacts-dir\", artifactsDirFlagDefault, artifactsDirFlagUsage)\n\tlifecycleHookCommand *string        = flag.String(\"lifecycle-hook\", lifecycleHookCommandFlagDefault, lifecycleHookCommandFlagUsage)\n\tstopSignal           *string        = flag.String(\"stop-signal\", stopSignalFlagDefault, stopSignalFlagUsage)\n\tstopGracePeriod      *time.Duration = flag.Duration(\"stop-grace-period\", stopGracePeriodFlagDefault, stopGracePeriodFlagUsage)\n\tenableMondel         *bool          = flag.Bool(\"mondel\", enableMondelFlagDefault, enableMondelFlagUsage)\n\n\terrUnknownMode = errors.New(\"unknown sensor mode\")\n)\n\nfunc eventsFilePath() string {\n\treturn filepath.Join(*artifactsDir, \"events.json\")\n}\n\nfunc init() {\n\tflag.BoolVar(getAppBom, \"b\", getAppBomFlagDefault, getAppBomFlagUsage)\n\tflag.BoolVar(enableDebug, \"d\", enableDebugFlagDefault, enableDebugFlagUsage)\n\tflag.StringVar(logLevel, \"l\", logLevelFlagDefault, logLevelFlagUsage)\n\tflag.StringVar(logFormat, \"f\", logFormatFlagDefault, logFormatFlagUsage)\n\tflag.StringVar(logFile, \"o\", logFileFlagDefault, logFileFlagUsage)\n\tflag.StringVar(sensorMode, \"m\", sensorModeFlagDefault, sensorModeFlagUsage)\n\tflag.StringVar(commandsFile, \"c\", commandsFileFlagDefault, commandsFileFlagUsage)\n\tflag.StringVar(artifactsDir, \"e\", artifactsDirFlagDefault, artifactsDirFlagUsage)\n\tflag.StringVar(lifecycleHookCommand, \"a\", lifecycleHookCommandFlagDefault, lifecycleHookCommandFlagUsage)\n\tflag.StringVar(stopSignal, \"s\", stopSignalFlagDefault, stopSignalFlagUsage)\n\tflag.DurationVar(stopGracePeriod, \"w\", stopGracePeriodFlagDefault, stopGracePeriodFlagUsage)","sourceCodeStart":79,"sourceCodeEnd":115,"githubUrl":"https://github.com/slimtoolkit/slim/blob/81940d17fa112cc678e32209214bcb2355cb3004/pkg/app/sensor/app.go#L79-L115","documentation":"The sensor entrypoint (app.go) declares errUnknownMode and newExecution/newSensor return it when the sensor is invoked with a mode flag value that doesn't match any known execution mode. It is a fail-fast configuration error.","triggerScenarios":"Starting the sensor container/binary with an unrecognized mode value (e.g. misspelled or unsupported --mode / MODE env) passed into newSensor/newExecution.","commonSituations":"Typo in the sensor mode argument; using a mode from a different version of the tool; hand-edited deployment manifests or Helm values with an invalid mode.","solutions":["Check the exact mode value against the supported modes in sensor/app.go","Fix the typo or unsupported mode in the deployment args/env","Upgrade/downgrade so sensor mode vocabulary matches the binary version"],"exampleFix":"// before\nargs: [\"--mode\", \"observe\"]   // unknown\n// after\nargs: [\"--mode\", \"monitor\"]   // supported mode","handlingStrategy":"validation","validationCode":"validModes := map[string]bool{\"monitor\": true /*, others from sensor/app.go */}\nif !validModes[sensorMode] { return fmt.Errorf(\"unsupported sensor mode %q\", sensorMode) }","typeGuard":null,"tryCatchPattern":"s, err := newSensor(mode, ...)\nif err != nil && errors.Is(err, errUnknownMode) {\n  return fmt.Errorf(\"fix --mode value; supported modes: see sensor docs\"): %w\", err\n}","preventionTips":["Keep mode values in deployment manifests/Helm values reviewed","Match mode vocabulary to the sensor binary version","Use a whitelist check in wrapper scripts before launching"],"tags":["sensor","configuration","cli"],"backgroundTag":"invalid-config-value","analyzedSha":"81940d17fa112cc678e32209214bcb2355cb3004","analyzedAt":"2026-08-31T23:06:12.682Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T05:18:18.240Z"}