title | tags | metaDescription | freshnessValidatedDate | translationType | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Acompanhe as alterações com GitHub Actions |
|
Here's how to use GitHub Actions to designate what you want to capture with change tracking. |
never |
machine |
Você pode usar o recurso Monitoramento de Alterações do New Relic em conjunto com GitHub Actions para monitor o efeito das alterações em seus clientes e sistemas. Com GitHub Actions, você pode designar quais alterações monitor e, em seguida, observar os resultados na interface do New Relic. Isso permite que você rastreie as alterações feitas em seu ambiente durante o pipeline de lançamento.
Aqui estão os elementos de entrada:
<th>
Obrigatório
</th>
<th style={{ width: "200px" }}>
Padrão
</th>
<th>
Descrição
</th>
</tr>
<td>
sim
</td>
<td>
n/a
</td>
<td>
O GUID da entidade para aplicar o marcador de alteração
</td>
</tr>
<tr>
<td>
`apiKey`
</td>
<td>
sim
</td>
<td>
n/a
</td>
<td>
Sua [chave de API pessoal](/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key)New Relic
</td>
</tr>
<tr>
<td>
`changelog`
</td>
<td>
não
</td>
<td>
n/a
</td>
<td>
Um resumo do que aconteceu nessa mudança que está visível na página <DoNotTranslate>**Change tracking**</DoNotTranslate>
</td>
</tr>
<tr>
<td>
`commit`
</td>
<td>
não
</td>
<td>
n/a
</td>
<td>
O Commit SHA para esta alteração que está visível na página <DoNotTranslate>**Change tracking**</DoNotTranslate>
</td>
</tr>
<tr>
<td>
`description`
</td>
<td>
não
</td>
<td>
n/a
</td>
<td>
Uma descrição resumida dessa alteração, visível na página <DoNotTranslate>**Overview**</DoNotTranslate> e na página <DoNotTranslate>**Change tracking**</DoNotTranslate> quando você seleciona uma alteração individual
</td>
</tr>
<tr>
<td>
`deeplink`
</td>
<td>
não
</td>
<td>
n/a
</td>
<td>
Um link direto para a fonte que desencadeou a mudança
</td>
</tr>
<tr>
<td>
`deploymentType`
</td>
<td>
não
</td>
<td>
`BASIC`
</td>
<td>
O tipo de implantação. Além do padrão `BASIC`, escolha entre `BLUE_GREEN`, `CANARY`, `OTHER`, `ROLLING` ou `SHADOW`
</td>
</tr>
<tr>
<td>
`groupId`
</td>
<td>
não
</td>
<td>
n/a
</td>
<td>
Um ID de grupo para a alteração vincular a outras alterações
</td>
</tr>
<tr>
<td>
`region`
</td>
<td>
não
</td>
<td>
`US`
</td>
<td>
A região da sua conta New Relic
</td>
</tr>
<tr>
<td>
`version`
</td>
<td>
sim
</td>
<td>
n/a
</td>
<td>
Metadados a serem aplicados ao marcador de mudança, como a tag de lançamento mais recente
</td>
</tr>
<tr>
<td>
`user`
</td>
<td>
sim
</td>
<td>
`github.actor`
</td>
<td>
Um nome de usuário para associar à alteração que está visível nas páginas <DoNotTranslate>**Overview**</DoNotTranslate> e <DoNotTranslate>**Deployments**</DoNotTranslate>
</td>
</tr>
Chave |
---|
`guid` |
Certifique-se de que os seguintes segredos do Github estejam definidos:
NEW_RELIC_API_KEY
- Chave pessoal de APINEW_RELIC_DEPLOYMENT_ENTITY_GUID
- New Relic Entity GUID para criar o marcador
Verifique a página do marcador de implantação do aplicativo New Relic e clique no botão Use latest version para certificar-se de usar a versão mais recente disponível.
Há diversas variáveis de ambiente padrão do GitHub que também são usadas nesses exemplos.
name: Change Tracking Marker
on:
release:
types: [published]
jobs:
newrelic:
runs-on: ubuntu-latest
name: New Relic
steps:
# This step builds a var with the release tag value to use later
- name: Set Release Version from Tag
run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
# This step creates a new Change Tracking Marker
- name: New Relic Application Deployment Marker
uses: newrelic/deployment-marker-action@v2.3.0
with:
apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID }}
version: "${{ env.RELEASE_VERSION }}"
user: "${{ github.actor }}"
Além de
NEW_RELIC_API_KEY
, este exemplo mostra como destinar vários itens armazenando vários segredos como "NEW_RELIC_DEPLOYMENT_ENTITY_GUID_<ID>
", onde<ID>
é o identificador exclusivo do item de destino.
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456
NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789
name: Change Tracking Marker
on:
workflow_dispatch:
release:
types: [published]
jobs:
newrelic:
runs-on: ubuntu-latest
name: New Relic
steps:
# This step builds a var with the release tag value to use later
- name: Set Release Version from Tag
run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
# This step creates a new Change Tracking Marker for App123
- name: App123 Marker
uses: newrelic/deployment-marker-action@v2.3.0
with:
apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App123 }}
version: "${{ env.RELEASE_VERSION }}"
changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
commit: "${{ github.sha }}"
description: "Automated Release via Github Actions"
deploymentType: "ROLLING"
groupId: "Workshop App Release: ${{ github.ref_name }}"
user: "${{ github.actor }}"
# This step creates a new Change Tracking Marker for App456
- name: App456 Marker
uses: newrelic/deployment-marker-action@v2.3.0
with:
apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App456 }}
version: "${{ env.RELEASE_VERSION }}"
changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
commit: "${{ github.sha }}"
description: "Automated Release via Github Actions"
deploymentType: "ROLLING"
groupId: "Workshop App Release: ${{ github.ref_name }}"
user: "${{ github.actor }}"
# This step creates a new Change Tracking Marker for App789
- name: App789 Marker
uses: newrelic/deployment-marker-action@v2.3.0
with:
apiKey: ${{ secrets.NEW_RELIC_API_KEY }}
guid: ${{ secrets.NEW_RELIC_DEPLOYMENT_ENTITY_GUID_App789 }}
version: "${{ env.RELEASE_VERSION }}"
changelog: "https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md"
commit: "${{ github.sha }}"
description: "Automated Release via Github Actions"
deploymentType: "ROLLING"
groupId: "Workshop App Release: ${{ github.ref_name }}"
user: "${{ github.actor }}"
Depois de designar as alterações que deseja rastrear, você pode analisar o efeito dessas alterações na interface do New Relic. Para obter detalhes, consulte Como visualizar e analisar suas alterações no New Relic.