Sha256: 9708f824e055641d42e4cb8debad7fd36125026931c6ce171c6a0fb92f0503ac

Contents?: true

Size: 1.24 KB

Versions: 24

Compression:

Stored size: 1.24 KB

Contents

# frozen_string_literal: true

require 'bolt/util/format'

# Log an error message.
#
# Messages logged at this level typically indicate that the plan encountered an
# error that can be recovered from. For example, you might log a message at the
# `error` level if you want to inform the user an action running on a target
# failed but that the plan will continue running.
#
# See [Logs](logs.md) for more information about Bolt's log levels.
#
# > **Note:** Not available in apply block
Puppet::Functions.create_function(:'log::error') do
  # Log an error message.
  # @param message The message to log.
  # @example Log an error message
  #   log::error("The HTTP request returned an error, continuing the plan: ${result}")
  dispatch :log_error do
    param 'Any', :message
    return_type 'Undef'
  end

  def log_error(message)
    unless Puppet[:tasks]
      raise Puppet::ParseErrorWithIssue.from_issue_and_stack(
        Bolt::PAL::Issues::PLAN_OPERATION_NOT_SUPPORTED_WHEN_COMPILING,
        action: 'log::error'
      )
    end

    Puppet.lookup(:bolt_executor).tap do |executor|
      executor.report_function_call(self.class.name)
      executor.publish_event(type: :log, level: :error, message: Bolt::Util::Format.stringify(message))
    end

    nil
  end
end

Version data entries

24 entries across 24 versions & 1 rubygems

Version Path
bolt-4.0.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.29.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.28.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.27.4 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.27.2 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.27.1 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.26.2 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.26.1 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.25.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.24.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.23.1 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.23.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.22.1 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.22.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.21.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.20.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.19.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.18.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.17.0 bolt-modules/log/lib/puppet/functions/log/error.rb
bolt-3.16.1 bolt-modules/log/lib/puppet/functions/log/error.rb