CloudWatch Exemples d'Observability Access Monitor utilisant AWS CLI

Pour créer un lien

L'create-linkexemple suivant crée un lien entre un compte source et un récepteur que vous avez créé dans un compte de surveillance.

aws oam create-link \
    --label-template sourceAccount \
    --resource-types AWS::CloudWatch::Metric \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour créer un évier

L'create-sinkexemple suivant crée un puits dans le compte courant, afin qu'il puisse être utilisé comme compte de surveillance dans le cadre de l' CloudWatch observabilité entre comptes.

aws oam create-sink \
    --name DemoSink

Sortie :

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour supprimer un lien

L'delete-linkexemple suivant supprime un lien entre un récepteur de comptes de surveillance et un compte source.

aws oam delete-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour supprimer un évier

L'delete-sinkexemple suivant supprime un évier. Vous devez supprimer tous les liens vers un récepteur avant de pouvoir supprimer ce dernier.

aws oam delete-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer des informations complètes sur un lien

L'get-linkexemple suivant renvoie des informations complètes sur un lien.

aws oam get-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Sortie :

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer la politique de récepteur actuelle attachée au récepteur

L'get-sink-policyexemple suivant renvoie la politique de récepteur actuelle attachée au récepteur.

aws oam get-sink-policy \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer des informations complètes sur un compte de surveillance, réceptacle

L'get-sinkexemple suivant renvoie des informations complètes sur un récepteur de compte de surveillance.

aws oam get-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer une liste des liens de comptes sources liés à ce compte de surveillance, réceptacle

L'list-attached-linksexemple suivant renvoie une liste de liens de comptes source liés à ce récepteur de comptes de surveillance.

aws oam list-attached-links \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "Items": [{
        "Label": "Monitoring account",
        "LinkArn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "ResourceTypes": [
            "AWS::ApplicationInsights::Application",
            "AWS::Logs::LogGroup",
            "AWS::CloudWatch::Metric",
            "AWS::XRay::Trace"
        ]
    }]
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer une liste de liens pour un compte de surveillance, réceptacle

L'list-linksexemple suivant renvoie une liste de liens pour un récepteur de comptes de surveillance. Exécutez cette opération dans un compte source pour renvoyer une liste de liens vers les récepteurs de compte de surveillance que possède ce compte source.

aws oam list-links

Sortie :

{
    "Items": [{
        "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
        "Label": "sourceAccount",
        "ResourceTypes": [
            "AWS::CloudWatch::Metric"
        ],
        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345"
    }]
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour renvoyer la liste des puits créés dans le compte de surveillance

L'list-sinksexemple suivant renvoie une liste de récepteurs créés dans le compte de surveillance. Exécutez cette opération dans un compte de surveillance.

aws oam list-sinks

Sortie :

{
    "Items": [
        {
            "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
            "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
            "Name": "DemoSink"
        }
    ]
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour afficher les balises associées à une ressource

L'list-tags-for-resourceexemple suivant affiche les balises associées à un récepteur.

aws oam list-tags-for-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "Tags": {
        "Team": "Devops"
    }
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour créer ou mettre à jour la politique de ressources

L'put-sink-policyexemple suivant crée la politique de ressources qui autorise les comptes source à établir un lien avec le récepteur de comptes de surveillance.

aws oam put-sink-policy \
    --policy '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789111:root"},"Action":["oam:CreateLink","oam:UpdateLink"],"Resource":"*","Condition":{"ForAllValues:StringEquals":{"oam:ResourceTypes":["AWS::Logs::LogGroup","AWS::CloudWatch::Metric","AWS::XRay::Trace","AWS::ApplicationInsights::Application"]}}}]}' \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Sortie :

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour attribuer une ou plusieurs balises à la ressource spécifiée

L'tag-resourceexemple suivant balise un évierarn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345.

aws oam tag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \
    --tags team=Devops

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour supprimer une ou plusieurs balises de la ressource spécifiée.

L'untag-resourceexemple suivant supprime une balise contenant la clé team du récepteurarn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345.

aws oam untag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \
    --tag-keys team

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.

Pour modifier les types de données partagés entre un compte source et son compte de surveillance associé (récepteur)

L'update-linkexemple suivant met à jour le lien arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0 avec les types de ressources AWS::CloudWatch::Metric etAWS::Logs::LogGroup.

aws oam update-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 \
    --resource-types "AWS::CloudWatch::Metric" "AWS::Logs::LogGroup"

Sortie :

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric",
        "AWS::Logs::LogGroup"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Pour plus d'informations, consultez la CloudWatch section sur l'observabilité entre comptes dans le guide de CloudWatch l'utilisateur Amazon.