Process.hs

{-# LANGUAGE  CPP #-}
{-# LANGUAGE DataKinds #-}
{-# LANGUAGE TypeFamilies #-}
-----------------------------------------------------------------------------
-- |
-- Module      :  OpenTelemetry.Resource.Process
-- Copyright   :  (c) Ian Duncan, 2021
-- License     :  BSD-3
-- Description :  Standard resources and detectors for system processes
-- Maintainer  :  Ian Duncan
-- Stability   :  experimental
-- Portability :  non-portable (GHC extensions)
--
-----------------------------------------------------------------------------
module OpenTelemetry.Resource.Process where
import Data.Text (Text)
import OpenTelemetry.Resource

-- |  An operating system process.
data Process = Process
  { processPid :: Maybe Int
  -- ^ Process identifier (PID).
  --
  -- Example: @1234@
  , processExecutableName :: Maybe Text
  -- ^ The name of the process executable. On Linux based systems, can be set to the @Name@ in @proc/[pid]/status@. On Windows, can be set to the base name of @GetProcessImageFileNameW@.
  --
  -- Example: @otelcol@
  , processExecutablePath :: Maybe Text
  -- ^ The full path to the process executable. On Linux based systems, can be set to the target of @proc/[pid]/exe@. On Windows, can be set to the result of @GetProcessImageFileNameW@.
  --
  -- Example: @/usr/bin/cmd/otelcol@
  , processCommand :: Maybe Text
  -- ^ The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in @proc/[pid]/cmdline@. On Windows, can be set to the first parameter extracted from @GetCommandLineW@.
  --
  -- Example: @cmd/otelcol@
  , processCommandLine :: Maybe Text
  -- ^ The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of @GetCommandLineW@. Do not set this if you have to assemble it just for monitoring; use @process.command_args@ instead.
  --
  -- Example: @C:\cmd\otecol --config="my directory\config.yaml"@
  , processCommandArgs :: Maybe [Text]
  -- ^ All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from @proc/[pid]/cmdline@. For libc-based executables, this would be the full argv vector passed to main.	
  --
  -- Example: @[cmd/otecol, --config=config.yaml]@
  , processOwner :: Maybe Text
  -- ^ The username of the user that owns the process.	
  --
  -- Example: @root@
  }

instance ToResource Process where
  type ResourceSchema Process = 'Nothing
  toResource Process{..} = mkResource
    [ "process.pid" .=? processPid
    , "process.executable.name" .=? processExecutableName
    , "process.executable.path" .=? processExecutablePath
    , "process.command" .=? processCommand
    , "process.command_line" .=? processCommandLine
    , "process.command_args" .=? processCommandArgs
    , "process.owner" .=? processOwner
    ]

-- | The single (language) runtime instance which is monitored.
data ProcessRuntime = ProcessRuntime
  { processRuntimeName :: Maybe Text
  -- ^ The name of the runtime of this process. For compiled native binaries, this SHOULD be the name of the compiler.	
  --
  -- Example: @OpenJDK Runtime Environment@
  , processRuntimeVersion :: Maybe Text
  -- ^ The version of the runtime of this process, as returned by the runtime without modification.	
  --
  -- Example: @14.0.2@
  , processRuntimeDescription :: Maybe Text
  -- ^ An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment.
  --
  -- Example: @Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0@
  }

instance ToResource ProcessRuntime where
  type ResourceSchema ProcessRuntime = 'Nothing
  toResource ProcessRuntime{..} = mkResource
    [ "process.runtime.name" .=? processRuntimeName
    , "process.runtime.version" .=? processRuntimeVersion
    , "process.runtime.description" .=? processRuntimeDescription
    ]