Add new monitor diagnostic setting modules

[l3ender]

SUMMARY

This PR adds support for configuring diagnostic settings for any Azure resource. Log and/or metric information from the resource can be sent to a variety of destinations.

An example which sends log information from an app service to an event hub:

- name: Create diagnostic setting for webapp to an event hub
  azure_rm_monitordiagnosticsetting:
    name: "webapp-logs"
    resource:
      name: "my-webapp"
      type: "Microsoft.Web/sites"
      resource_group: "my-webapp-resource-group"
    event_hub:
      namespace: "my-event-hub"
      policy: "RootManageSharedAccessKey"
    logs:
      - category: "AppServiceConsoleLogs"
      - category: "AppServiceAppLogs"

Fixes #529.

ISSUE TYPE

• New Module Pull Request

COMPONENT NAME

azure_rm_monitordiagnosticsetting
azure_rm_monitordiagnosticsetting_info

ADDITIONAL INFORMATION

I have added extensive test coverage, which can be run using a playbook like the following:

---
- name: "Playbook for testing."
  hosts: "localhost"
  connection: "local"
  gather_facts: false
  vars:
    resource_group: "automated-testing"
    resource_group_secondary: "automated-testing-secondary"
  collections:
    - azure.azcollection

  tasks:
    - name: "Include tests"
      include_tasks: "tests/integration/targets/azure_rm_monitordiagnosticsetting/tasks/main.yml"

[l3ender]

Hi @Fred-sun, here is a module which I think will be very helpful for people. I saw #530 addressed the same issue, but the PR was quite stale and did not offer much flexibility. So I have raised this PR and hope it will be useful.

Please review and advise--thank you!

[Fred-sun]

@l3ender A lot of normative questions about module documentation, Please refer to the link - https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_documenting.html#developing-modules-documen ting

[Fred-sun]

@l3ender The return value suboption paramter is "contain", not suboptions. Thank you!

[l3ender]

Thanks for the review, @Fred-sun, and sorry for the silly documentation syntax mistakes. Thanks for providing the URL for detail on how to generate documentation; I will be looking more into that.

Please take another look. Thank you!

[l3ender]

Hello, wondering if there is anything else I can do for this PR? Thank you!

[Fred-sun]

Hello, wondering if there is anything else I can do for this PR? Thank you!

@l3ender We are reviewing and will push forward the merger as soon as possible. Thank you very much!

[l3ender]

Hello, is anything else desired for this PR? Thank you!

[xuzhang3]

@l3ender LGTM, shipping it.