azurerm_monitor_log_profile resource

[edit on GitHub]

Use the azurerm_monitor_log_profile InSpec audit resource to test properties of an Azure Monitor Log Profile.

Azure REST API version

This resource interacts with version 2016-03-01 of the Azure Management API. For more information see the official Azure documentation.

At the moment, there doesn’t appear to be a way to select the version of the Azure API docs. If you notice a newer version being referenced in the official documentation please open an issue or submit a pull request using the updated version.

Availability

Installation

This resource is available in the inspec-azure resourcepack. To use it, add the following to your inspec.yml in your top-level profile:

depends:
  - name: inspec-azure
    git: https://github.com/inspec/inspec-azure.git

You’ll also need to setup your Azure credentials; see the resource pack README.

Syntax

An azurerm_monitor_log_profile resource block identifies a Log Profile by name.

describe azurerm_monitor_log_profile(name: 'default') do
  ...
end

Examples

Test that a Log Profile exists

describe azurerm_monitor_log_profile(name: 'default') do
  it { should exist }
end

Test that Log Profile retention is enabled

describe azurerm_monitor_log_profile(name: 'default') do
  its('retention_enabled') { should be true }
end

Parameters

• name

Parameter Examples

The name of the Log Profile.

describe azurerm_monitor_log_profile(name: 'default') do
  it { should exist }
end

Attributes

• retention_enabled
• retention_days

retention_enabled

Determine if retention is enabled

its('retention_enabled') { should be true }

retention_days

Determine number of days retention is enabled for

its('retention_days')    { should eq(365) }

Other Attributes

There are additional attributes that may be accessed that we have not documented. Please take a look at the Azure documentation. Any attribute in the response may be accessed with the key names separated by dots (.).

The API may not always return keys that do not have any associated data. There may be cases where the deeply nested property may not have the desired attribute along your call chain. If you find yourself writing tests against properties that may be nil, fork this resource pack and add an accessor to the resource. Within that accessor you’ll be able to guard against nil keys. Pull requests are always welcome.

Matchers

This InSpec audit resource has the following special matchers. For a full list of available matchers, please visit our Universal Matchers page.

exists

The control will pass if the resource returns a result. Use should_not if you expect zero matches.

#  If we expect 'default' to exist
describe azurerm_monitor_log_profile(name: 'default') do
  it { should exist }
end

# If we expect 'default' to not exist
describe azurerm_monitor_log_profile(name: 'default') do
  it { should_not exist }
end

Azure Permissions

Your ServicePrincipal must be setup with a contributor role on the subscription you wish to test.